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Section 5: Miscellaneous Topics 


Entry Name(Section): name 

intro(5) . 

acl(5); acl . 

aio(5): aio() . 

aliases(5): aliases . 

ascii(5): ascii . 

audio(5): audio. 

audit(5) . 

curses(5): curses . 

dirent(5): dirent.h . 

dld.sl(64): did. si . 

environ(5): environ . 

fcntl(5) . 

fenv(5): fenv, acosf () . 

fs_wrapper(5) . 

hier(5): hier . 

hostname(5): hostname .... 

inttypes(5): inttypes . 

ioctl (5): ioctl . 

Iang(5): lang . 

langinfo(5): langinfo . 

Iibcrash(5): libcrash . 

Iimits(5): limits . 

man (5): man. 

manuals(5). 

math (5): math . 


Description 

.introduction to miscellany 

.introduction to access control lists 

.POSIX asynchronous I/O 

.aliases file for sendmail 

.map of ASCI I character set 

.audio tools availablethrough HP VUE 

.introduction to HP-UX Auditing System 

.definition for screen handlingand optimisation functions 

.format of directory streams and directory entries 

.dynamic loader 

.user environment 

.file control options 

.floating-point environment macros and functions 

configuration and binary files used by file system administration commands 

.file system hierarchy 

.host name resolution description 

.basic integer data types 

.generic device control commands 

.description of supported languages 

.languageinformation constants 

.crash dump access library 

.implementation-specific constants 

.macros for formatting manpages 

.current list of orderable HP-UX documentation 

.math functions and constants 


mknod(5): mknod.macros for handling device numbers 

mm(5): mm .the M M macro package for formatting documents 

mman(5) .memory mapping definitions 

mtab: mounted file system table.see pfs_fstab(5) 

ndir(5): ndir.h .format of HP-UX directory streams 

nlio(5): nlio .Native Language I/O (N LI O) Subsystem 

pam_unix(5): pam_unix authentication, account, session, and password management PAM modules for UNIX 

pam_updbe(5): pam_updbe .PAM user policy definition module 

pd_att(5) .index of attribute manpagessfor HP Distributed Print Service 

pd_att_document(5) .list of attributes for a document object (HP Distributed Print Service) 

pd_att_ivdocument(5).list of attributes for an initial valuedocument object (HP Distributed Print Service) 

pd_att_ivjob(5).list of attributes for an initial valuejob object (HP Distributed Print Service) 

pd_attjob(5) .list of attributes for a job object (HP Distributed Print Services) 

pd_att_log(5).list of attributesfor a log object (HP Distributed Print Service) 

pd_att_log_ptr(5).list of attributesfor a logical printer object (HP Distributed Print Services) 

pd_att_phy_ptr(5) .list of attributesfor a physical printer object (HP Distributed Print Service) 

pd_att_queue(5).list of attributesfor a queue object (HP Distributed Print Service) 

pd_att_spooler(5).list of attributesfor a spooler object (HP Distributed Print Service) 

pd_att_supervisor(5).list of attributesfor a supervisor object (HP Distributed Print Service) 

pfs_exports(5): pfs^exports.directories to export to PFS clients 

pfs_fstab(5): pfs_fstab.static file system mounting table 

pfs_xtab(5): directories to export to PFS clients.see fps_exports(5) 

portal(5): portal, h .header file for future applications 

quota(5): quota .disk quotas 

rcsintro(5): rcsintro .description of RCS commands 

regexp(5): <regexp.h> .regular expression and pattern matching notation definitions 

sd(5).create, distribute, install, monitor, and manage software 

signal(5): signal.h.description of signals 

signal.h: description of signals.seesignal(5) 

sis(5).secure internet services description 
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Entry Name(Section): name Description 

stat(5): stat .data returned by stat/fstat/istat system call 

stdarg(5): stdarg .handlevariableargument list 

stdsyms(5): stdsyms .description of HP-UX header file organization 

suffix(5): suffix .file-name suffix conventions 

term(5): term .terminal capabilities 

types(5) .primitive system data types 

unctrl(5): unctrl .definition for unctrl () 

unistd(5): unistd.h .standard structures and symbolic constants 

unistd.h: standard structures and symbolic constants. seeunistd(5) 

values(5) .machine-dependent values 

varargs(5): varargs.h .handle variableargument list 

x_open(5) .pointer to manual entry for X/Open Conformance Statement Questionnaire 


Section 7: Device (Special) Files 


Entry Name(Section): name 

intro(7) . 

arp(7P): arp . 

autochanger (7): autochanger 

blmode(7): blmode . 

cent(7): cent . 

clone(7) . 

console(7): console . 

ct(7): ct . 

ddfa(7): ddfa . 

diag0(7): diagO . 

disk(7): disk . 

fddi(7). 

floppy(7): floppy . 

framebuf(7): framebuf . 

hi 1(7): hil . 

hi Ikbd(7): hilkbd. 

hpib(7): hpib . 

inet(7F): inet . 

iomap(7): iomap . 

IP(7P): IP . 

kmem: kernel memory. 

kmem(7): kmem . 

Ian(7): lan . 

Idterm(7): ldterm . 

Ip(7): 1 P . 

Ivm(7): lvm . 

mem(7): mem, kmem. 

modem(7): modem. 

mt(7): mt . 

nfs(7): nfs, NFS . 

null(7): null . 

pckt(7): pckt . 

ps2(7): ps2, ps2kbd, ps2mouse 

ptem(7): ptem . 

ptm(7): ptm . 

pts(7): pts . 

pty(7): pty . 

routing(7). 

sad(7) . 

scsi(7): scsi . 

scsi_ctl(7): scsi_ctl . 

scsi_disk(7): scsi disk. 

SCSi_pt(7): scsi_pt . 

scsi_tape(7): scsi tape . 

socket(7): socket . 


Description 

.introduction to device special files 

.address resolution protocol 

.SCSI media changer device drivers 

.terminal block mode interface 

.Centronics-compatible interface 

.open a major and minor device pair on a STREAMS driver 

.system console interface 

.cartridge tape access 

Data Communications and Terminal Controller Device File Access software 

.diagnostic interface to I/O subsystem 

.direct disk access 

.Fiber Distributed Data I nterfaceTools 

.flexible or "floppy" disk device driver 

.information for raster frame-buffer devices 

.HP-HIL device driver 

.HP-HI L mapped keyboard driver 

.Hewlett-Packard I nterface Bus driver 

.Internet protocol family 

.physical address mapping 

.I nternet Protocol 

.see mem(7) 

.perform I/O on kernel memory based on symbol name 

.network I/O card access information 

.STREAMS terminal line discipline module 

.line printer 

.Logical Volume Manager (LVM) 

.main memory 

.asynchronous serial modem line control 

.magnetic tape interface for stape, tapel, andtape2 

.network filesystem 

.null file 

.Packet Mode modulefor STREAMS pty 

.PS/2 keyboard and mouse device driver and files 

.STREAMS pty (pseudo-terminal) Emulation module 

.STREAMS master pty (pseudo-terminal) driver 

.STREAMS slave pty driver 

.pseudo terminal driver 

.system support for local network packet routing 

.STREAMS administrative driver 

.Small Computer System Interface (SCSI) device drivers 

.SCSI pass-through device driver 

.SCSI direct access device driver 

.SCSI pass-through device driver 

.SCSI sequential access device driver 

.Interprocess communications 
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Entry Name(Section): name 

streamio(7) . 

strlog(7) . 

sttyv6(7): stty . 

TCP(7P): TCP . 

telm: STREAMS Telnet master driver 
tels(7): tels, telm . 


Description 

.STREAMS ioctl commands 

.STREAMS log driver 

terminal interface for Version 6/PWB compatibility 

.Internet Transmission Control Protocol 

.seetels(7) 

.STREAMS slave and master drivers 


termio(7): termio, termios . 

termios: general terminal interface 

termiox(7): termiox . 

timod(7) . 

tirdwr(7). 

tty(7): tty . 

UDP(7P): udp . 

UNIX(7P): UNIX . 

vxfsio(7) . 


.general terminal interface 

.seetermio(7) 

.extended general terminal interface 

STREAMS module for reads and writes by Transport I nterface users 
STREAMS module for reads and writes by Transport I nterface users 

.controlling terminal interface 

.Internet user datagram protocol 

.local communication domain protocol 

.VxFS filesystem control functions 


xopen_networking(7): xopen networking 


I nterprocess communications 


Section 9: General Information 


Entry Name(Section): name 

intro(9) . 

glossary(9) . 

Introduction^) . 


Description 

.introduction to the general information section 

.a description of common HP-UX terms 

an introduction to the HP-UX operating system and the HP-UX Reference 
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NAME 


intro - introduction to miscellany 

DESCRIPTION 

This section describes miscellaneous facilities such as macro packages, character set tables, and the file sys¬ 
tem hierarchy. 


SEE ALSO 

I ntroduction(9). 
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NAME 

acl - introduction to access control lists 

DESCRIPTION 

Access control lists are a key enforcement mechanism of discretionary access control (see Definitions 
below), for specifying access to files by users and groups more selectively than traditional hp-ux mechan¬ 
isms allow. 

hp-ux already enables non-privileged users or processes, such as file owners, to allow or deny other users 
access to files and other objects on a "need to know" basis, as determined by their user and/or group iden¬ 
tity (see passwd(4) and group(4)). This level of control is accomplished by setting or manipulating a file's 
permission bits to grant or restrict access by owner, group, and others (see chmod(2)). 

ACLs offer a greater degree of selectivity than permission bits, acls allow the file owner or superuser to 
permit or deny access to a list of users, groups, or combi nations thereof. 

acls are supported as a superset of the UNIX operating system discretionary access control (DAC) mechan¬ 
ism for files, but not for other objects such as inter-process communication (I PC) objects. 

Definitions 

Because control of access to data is a key concern of computer security, we provide the foil owing definitions, 
based on those of the Department of Defense Trusted Computer System Evaluation Criteria, to explain 
further both the concepts of access control and its relevance to hp-ux security features: 

access "A specific type of interaction between a subject and an object that results in the flow 

of information from one to the other." Subjects include "persons, processes, or devices 
that cause information to flow among objects or change the system state." Objects 
include files (ordinary files, directories, special files, FIFOs, etc.) and inter-process com¬ 
munication (I PC) features (shared memory, message queues, semaphores, sockets). 

access control list (ACL) 

An access control list is a set of (user.group, mode) entries associated with a file that 
specify permissions for all possible user-1 D/group- id combinations. 

access control list (ACL) entry 

An entry in an acl that specifies access rights for one user and group ID combination. 

change permission 

The right to alter DAC information (permission bits or acl entries). Change permis¬ 
sion is granted to object (file) owners and to privileged users. 

discretionary access control (DAC) 

"A means of restricting access to objects based on the identity of subjects and/or 
groups to which they belong. The controls are discretionary in the sense that a sub¬ 
ject with a certain access permission is capable of passing that permission (perhaps 
indirectly) to any other subject." 

mode Three bits in each ACL entry which represent read, write, and execut^search permis¬ 

sions. These bits may exist in addition to the 16 mode bits associated with every file 
in thefilesystem (seeglossary(9)). 

privilege The ability to ignore access restrictions and change restrictions imposed by security 
policy and implemented in an access control mechanism. In hp-ux, superusers and 
members of certain groups (see privgrp(4)) aretheonly privileged users. 

restrictive versus permissive 

An individual ACL entry is considered restrictive or permissive, depending on context. 
Restrictive entries deny a user and/or group access that would otherwise be granted 
by less-specific base or optional ACL entries (see below). Permissive entries grant a 
user and/or group access that would otherwise be denied by less-specific base or 
optional ACL entries. 

Access Control List Entries 

An access control list (ACL) consists of sets of (user.group, mode) entries associated with a file that specify 
permissions. Each entry specifies for one user-iD/group-iD combination a set of access permissions, includ¬ 
ing read, write, and execute/search. 
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To help understand the relationship between access control lists and traditional file permissions, consider 
thefollowingfileand its permissions: 

-rwxr-xr-- james admin datafile 

The file owner is user james. 

The file's group is admin. 

The name of the file is datafile. 

The file owner permissions are rwx. 

The file group permissions are r-x. 

The file other permissions are r--. 

I n an ACL, user and group IDs can be represented by names or numbers, found in /etc/passwd. The fol¬ 
lowing special symbols can also be used: 

% Symbol representing no specific user or group. 

@ Symbol representing the current file owner or group. 

Base ACL Entries 

When a file is created, three base access control list entries are mapped from the file's access permission 
bits to match a file's owner and group and its traditional permission bits. Base ACL entries can be changed 
by the chmod(2) and setacl (2) system calls. 

(uid.%,mode) Base ACL entry for the file's owner 
(%.gid,mode) Base ACL entry for the file's group 
(%.%,mode) Base entry for other users 

(Except where noted, examples are represented in short form notation. See ACL Notation, below.) 

Optional ACL entries 

Optional access control list entries contain additional access control information, which the user can set 
with the setacl (2) system call to further allow or deny file access. Up to thirteen additional user/group com¬ 
bi nations can be specified. 

For example, the foil owing optional access control list entries can be associated with our file: 

(mary.admin, rwx) Grant read, write, and execute access to user mary in group admin. 

(george.%, —) Deny any access to user george in no specific group. 

ACL Notation 

Supported library calls and commands that manage acls recognize three different symbolic representa¬ 
tions: 

operator form For input of entireACLs and modifications to existing acls, in a syntax similar to that used 
by chmod(l). 

short form Easier to read, intended primarily for output, chad (1) accepts this form as input so that it 
can interpret output from I sad (1). 

long form A multi-lineformat useful for greater clarity, and supported only for output. 

For our example file, the base ACL entries could be represented in the three notations as follows: 
operator form james.% = rwx, %.admin = rx, %.% = r 
short form (james.%,rwx) (%.admin,r-x) (%.%,r--) 

long form rwx james.% 

r-x %.admin 

r~ %.% 

In addition tobasicACL usage, some library calls and commands understand and usea variation of operator 
and short forms. See the section below on ACL Patterns. 

ACL Uniqueness 

Entries are unique in each ACL. There can only be one (u.g, mode) entry for any pair of u and g values; one 
(u.%, mode) entry for a given value of u; one (%.g, mode) entry for a given value of g; and one (%.%, mode) 
entry for each file. For example, an ACL can have a (23.14, mode) entry and a (23.%, mode) entry, but not 
two (23.14, mode) entries or two (23.%, mode) entries. 
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Access Check Algorithm 

acl entries can be categorized by four levels of specificity. In access checking, acls are compared to the 
effective user and group I Ds in this order: 

(u.g, rwx) specific user, specific group 
(u.%, rwx) specific user, no specific group 
(%.g, rwx) no specific user, specific group 
(%.%, rwx) no specific user, no specific group 

Once an entry for the combination of a process effective user id and effective group id (or any supplemen¬ 
tary group id) is matched, no further (that is, less specific) entries are checked. More specific entries that 
match take precedence over any less specific ones that also match. 

If a process has more than one group id (that is, a non-null supplementary groups list), more than one (u.g, 
mode) or (%.g, mode) entry might apply for that process. If so, the access modes in all matching entries (of 
the same level of specificity, u.g or %.g) are OR'd together. Access is granted if the resulting mode bits 
allow it. Si nee entries are unique, the order of entries in each entry type is insignificant. 

Because the traditional UNIX permission bits are mapped into base ACL entries, they are included in access 
checks. 

If a request is made for more than one type of access, such as opening a file for both reading and writing, 
access is granted only if the process is allowed all requested types of access. Note that access can be 
granted if the process has two groups in its groups list, one of which is only allowed read access, and the 
other of which is only allowed write access. I n other words, even if the requested access is not granted by 
any one entry, it may be granted by a combination of entries due to the process belonging to several groups. 


Operator Form of ACLs (input only) 

user, group operator model operator mode]. 

M ultiple entries are separated by commas, as in chmod(l). Each entry consists of a user identifier and 
group identifier followed by one or more operators and mode characters, as in the mode syntax accepted by 
chmod(l). 

The entire acl must be a single argument, and thus should be quoted to the shell if it contains whitespace 
or special characters. Whitespace is ignored except within names. A null acl is legitimate, and means 
either "no access" or "no changes", depending on context. 

Each user or group id may be represented by: 

name Valid user or group name, 

number Valid numeric id value. 

% "No specific user or group," as appropriate. 

@ "Current file owner or group," as appropriate; useful for referring to a file's u.% and %.g 

base ACL entries. 

An operator is always required in each entry. Operators are: 

= Set all bits in the entry to the given mode value. 

+ Set the indicated mode bits in the entry. 

Clear the indicated mode bits in the entry. 

The mode is represented by an octal value of 0 through 7; or any combination of r, w, and x can be given in 
any order (see examples below). A null mode denies access if the operator is =, or represents "no change" 
if the operator is +or -. 

Multiple entries and multiple operator-mode parts in an entry are applied in the order specified. Conflicts 
do not result in error; the last specified entry or operator takes effect. Entries need not appear in any par¬ 
ticular order. 

Note that chmod(l) allows only u, g, o, or a to refer symbolically to the file owner, group, other, or all 
users, respectively. Since acls work with arbitrary user and group identifiers, @is provided as a conveni¬ 
ence. 


The exact syntax is: 


acl 

: := [entry[,entry] • • 

] 

entry 

::= id . id op mode 

[op mode] 

id 

::= name | number 

% 1 @ 

op 

::= = 1 + 1 - 
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mode ::= 0..7 | [char [char] ... ] 

char ::= r | w | x 


Short Form of ACLs (input and output) 

(user . group, mode) ... 

Short form differs from operator form in several ways: 

• Entries are surrounded by parentheses rather than being separated by commas. 

• Each entry specifies the mode, including all mode bits. It is not possible to change the mode value 
with +and -operators. However, thecomma functions I ike the =operator in operator form. 

• For clarity, hyphens represent unset permission bits in the output of the mode field and are allowed in 
input. This resembles the mode output style used by ls(l). 

M ultiple entries are concatenated. For consistency with operator form, a dot (.) is used to separate user 
and group IDs. 

On output, no whitespace is printed except in names (if any), id numbers are printed if no matching names 
are known. Either id can be printed as % for "no specific user or group." The mode is represented as 
<r| -xw| -xx| ->, that is, it always has three characters, padded with hyphens for unset mode bits. If the 
ACL is read from the system, entries are ordered by specificity, then by numeric values of id parts. 

On input, the entire ACL must be a single argument, and thus should be quoted to the shell if it contains 
whitespace or special characters. Whitespace is ignored except within names. A null ACL is legitimate, and 
means either "no access" or "no changes", depending on context. 

User and group IDs are represented as in operator form. 

The mode is represented by an octal value of 0 through 7; or any combination of r, w, x and - (ignored) can 
be given in any order (see exam ples below). A null mode denies access. 

Redundancy does not result in error; the last entry for any user-iD/group-iD combination takes effect. 
Entries need not appear in any particular order. 

The exact syntax is: 


acl 

: := [entry[entry] . . . ] 

entry 

::= (id. id, mode) 

id 

: := name | number | % | @ 

mode 

: := o. . 7 | [char[char] . . . 

char 

: := r | w | x | - 


Long Form of ACLs (output only) 

mode user . group 

Each entry occupies a single line of output. The mode appears first in a fixed-width field, using hyphens 
(for unset mode bits) for easy vertical scanning. Each user and group id is shown as a name if known, a 
number if unknown, or %for "no specific user or group." Entries are ordered from most to least specific, 
then by numeric values of id parts. 

Note that every ACL printed has at least three entries, the base ACL entries (that is, uid.%, %.gid, and 
%.%). 


The exact syntax is: 


ad 

::= entry [<newline>entry] 

entry 

::= mode<space>id. id 

mode 

::= <r | -><w | -><x |-> 

id 

::= name | number | % 


ACL Patterns 

Some library calls and commands recognize and use ACL patterns instead of exact ACLs to allow operations 
on all entries that match the patterns, acl syntax is extended in thefollowing ways: 

wildcard user and group IDs 

A user or group name of * (wildcard) matches the user or group id in any entry, including 
% (no specific user or group). 
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mode bits on, off, or ignored 

For operator-form input, theoperators =, +, and -are applied as follows: 

= entry mode value matches this mode value exactly 
+ these bits turned on in entry mode value 
these bits turned off in entry mode value 

When only + and - operators are used, commands ignore the values of unspecified mode 
bits. 

Short-form patterns treat the mode identically to the =operator in operator form, 
wildcard mode values 

A mode of * (wildcard) in operator or short form input (for example, "ajs.%=*" or 
"(ajs.%,*)") matches any mode value, provided no other mode value is given in a operator- 
form entry. Also, the mode part of an entry can be omitted altogether for the same effect. 

entries not combined 

Entries with matching user and group id values are not combined. Each entry specified is 
applied separately by commands that accept patterns. 

ACL Operations Supported 

The system calls setacl (2) and getacl (2) allow setting or getting the entire ACL for a file in the form of an 
array of ad_entry structures. To check access rights to a file, see access(2) and getaccess(2). 

Various library calls are provided to manageACLs: 
adtostr(3C) Convert ad_entry arrays to printable strings, 
strtoacl (3C) Parse and convert ACL strings to ad_entry arrays, 
strtoacl patt(3C) 

Parse and convert ACL pattern strings to ad_entry_patt arrays. 

setaclentry(3C) 

fsetaclentry Add, modify, or delete a singleACL entry in onefile's ACL. 
cpad (3C) 

fcpad Copy an ACL and file miscellaneous mode bits (see chmod(2)) from one file to another, 

transfer ownership if needed (see below), and handle remote files correctly. 

chownacl(3C) Change the file owner and/or group represented in an ACL, that is, transfer ownership (see 
below). 

The foil owing commands are avail able to manageACLs and permissions: 

chad (1) Add, modify, or delete individual entries or all optional entries in acls on one or more files, 

remove all access to files, or incorporateACLs into permission bits. 

Isad(l) List acls on files. 

chmod(l) Change permission bits and other file miscellaneous mode bits. 

Is(l) In long form, list permission bits and other file attributes. 

find(l) Find files according to their attributes, includingACLs. 

getaccess(l) List access rights to file(s). 

ACL Interaction with stat(2), chmod(2), and chown(2) 
stat The st_mode field summarizes the caller's access rights to the file. It differs from file permission 
bits only if the file has one or more optional entries applicable to the caller. The st_basemode field 
provides the file's actual permission bits. The st_acl field indicates the presence of optional ACL 
entries in thefile'sACL. 

The st_mode field contains a user-dependent summary, so that programs ignorant of ACLs that use 
stat(2) and chmod(2) are more likely to produce expected results, and so that stat(2) provides rea- 
sonable information about remote files over NFS. The st basemode and st acl fields are useful only 
for local files. 

chmod For conformance with IEEE Standard POSIX 1003.1-1988, chmod(2) deletes any optional entriesin 
a file's ACL. Unfortunately, since chmod(2) is used to set file miscellaneous mode bits as well as 
permission bits, extra effort is required in some cases to preserve a file's ACL. 
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chown If the new owner and/or group of a file does not already have an optional (u.%, mode) and/or (%.g, 
mode) entry in the file's ACL, it inherits the old owner's and/or group's file access permission bits 
and base ACL entry: 

(idl,model) -> (id2,model) 

This is the traditional behavior. However, if the new owner and/or group of a file already has an 
optional (u.%, mode) and/or (%.g, mode) entry in thefile'sACL, theACL does not change: 

(idl, model) ->(idl, model) 

(id2, mode2) -> (id2, mode2) 

Existing access information in theACL is preserved. However, because the old optional ACL entry 
becomes the new base ACL entry and vice versa, thefile's access permission bits change. 

Transferring ownership of acls by chown(2) allows a file to be transferred to a different user or 
group, or copied by a different user or group than the owner (using cpad(3C) or chownacl(3C)), 
and later returned to the original owner or group without net changes to its ACL. The extra com¬ 
plexity is necessary because: 

• acls are a backward-compatible superset of permission bits (which are coupled to file owner 
and group IDs), not a replacement for them. 

• it enables users and programs that deal with ACLs to do so simply, rather than with a combi¬ 
nation of permission bits and acl entries. Also, the access check algorithm is simpler and 
more symmetrical; permission bits do not "eclipse" or "mask" ACL entries. 

EXAMPLES 

Operator Form 

The foil owing sets the %.% entry to restrict "other" users to only reading the file. 

chad ’%.% = r' myfile 

The following allows user "bill" in any group to write the file, assuming that no restrictive entry is more 
specific than the bill.% entry (for example, a bill.adm entry that denies writing). 

chad 'bill.% +W 1 myfile 

ThefollowingACL specification contains two entries. The first one deletes write and adds read capability to 
the entry for user 12, group 4. The second entry denies access for any unspecified user in any unspecified 
group. 

chad '12.4-w+r, %.% - myfile 

The following pair of entries sets the u.% entry for the file's owner to allow both read and execute and 
results in adding write and execute capabilities for "other" users (the"%.%" entry). Note that a mode char¬ 
acter is purposely repeated for illustration purposes. 

chad '@% = 5, %.% +xwx' myfile 
Short Form 

Here is a typical ACL as it might be printed. It allows user jpc to read or execute the file while in group 
adm; it denies user ajs access to the file while in group trux; it allows user jpc in any group (except adm) 
to only read the file; any other user in group bin may read or execute the file; and any other user may only 
read the file. 

(j pc .adm,r-x)(ajs.trux,—)(j pc.%r--)(%bi n,r -x)(%%r --) 

The following allows "other" users to only read thefile. 

chad '(%%r)' myfile 

The following sets write-only access for user bill in any group. 

chad '(bill.%-w-)' myfile 

The foil owing sets the entry for user 12 in group 4 to allow read and write. 

chad '(12.4>wr)' myfile 

The following sets the base ACL entry for the file's owner to allow both read and execute, and sets write 
and execute capabilities for "other" users (the"%.%" entry). 
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chad '(@% 5) (%.% xwx)' myfile 
Long Form 

Here is the sameACL as in an earlier example, printed in long form. 

r—x jpc.adm 

- ajs.trux 

r— jpc.% 
r-x %.bin 
r— % . % 

ACL Patterns 

The following command locates files whoseACLs contain an entry that allows read access and denies write 
access to some user/group combination. 

find / -acl '^-tr-w' -print 

The following matches entries for any user in group bin and for user tammy in any group, regardless of 
the entries' mode values. Matching optional ACL entries are deleted and mode values in matching base 
ACL entries are set to zero: 

chad -d '%.bin, tammy.*=*' myfile 

The following matches all entries, deleting optional entries and setting mode values of base ACL entries to 
zero: 


chad -d myfile 


HEADERS 

Header <sys/acl.h> 

The <sys/acl.h> header file defines the foil owing constants to govern the numbers of entries per ACL: 

NACLENTRIES maximum number of entries per ACL, including baseentries 
NBASEENTRIES number of base entries 

NOPTENTRIES number of optional entries 

The ACL entry structure struct acl_entry is also defined, and includes the foil owing members: 

aclidt uid; /* user ID */ 

aclid t gid; /* group ID */ 

aclmode_t mode; /* see <unistd.h> */ 

The <sys/acl.h> header also defines the types aclid_t and aclmode_t. 

Non-specific user and group ID values: 

ACL_NSUSER non-specific user ID 

ACLNSGROUP non-specific group I D 

A special nentries value ACL DELOPT is used with setacl (2) to delete optional entries. 


Header <sys/getaccess.h> 

The <sys/getaccess.h> header defines constants for use with getaccess(2). 
Special parameter values for uid: 

UID_EUID use effective user ID 
UI D_RU ID use real user ID 
UID SUID use saved user I D 


Special parameter values for ngroups: 


NGROUPSEGID 
NGROU PSRGID 
NGROU PSSGID 
NGROU PS_SUPP 
NGROU PS_EGID_SUPP 
NGROU PS RGI D SUPP 
NGROUPS SGI D SUPP 


process's effective gid 

process's real gid 

process's saved gid 

process's supplementary groups only 

process's eff gid plus supp groups 

process's real gid plus supp groups 

process's saved gid plus supp groups 
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Header <acllib.h> 

The <acllib.h> header file defines several constants for use with ACL support library calls. 
Symbolic forms of ACLs for adtostrQ: 

FORMSHORT 

FORMLONG 

Magic values for various calls: 


ACLFILEOWNER 
ACLFILEGROUP 
ACLANYUSER 
ACLANY GROUP 
MODEDEL 


file's owner ID 
file's group ID 
wildcard user ID 
wildcard group ID 
delete one ACL entry 


Mask for valid mode bits in ACL entries: 


MODEMASK 

(R_OK | W OK 

| X_OK) 



The <acliib.h> header also defines 
includes thefollowing members: 

the struct 

acl_entry_patt ACL 

pattern entry structure, which 

aclid_t 

uid; 

/* user 

ID */ 


aclid_t 

gid; 

/* group ID */ 


aclmode_t 

onmode; 

/* mode 

bits that must be 

on */ 

aclmode_t 

offmode; 

/* mode 

bits that must be 

off */ 


WARNINGS 

acls are intended for use on ordinary files and directories. Optional ACL entries are not recommended on 
files that are manipulated by certain system utilities, such as terminal special files and lp scheduler control 
files. These utilities might delete optional entries, including those whose intent is restrictive, without 
warning as a consequence of calling chmod(2), thereby increasing access unexpectedly. 

Most, but not all, supported utilities are ableto handle ACLs correctly. Flowever, only the fbackup(lM) and 
frecover(lM) file archive utilities handle access control lists properly. When using programs (such as 
archive programs ar(l), cpio(l), ftio(l), tar(l), and dump(lM)) unableto handle ACLs on files with optional 
ACL entries, note the Access Control List information included on their respective reference pages, to avoid 
loss of data. 

If a user name is defined in the /etc/passwd file or a group name is defined in the /etc/group file as % or 
@ or for patterns, *, ACL syntax cannot reference that name as itself because the symbols have other 
meanings. Flowever, such users or groups can still be referenced by their id numbers. User and/or group 
names must not includethefollowing characters: 

. Do not use in user names. 

+ Do not use in group names. 

Do not use in group names. 

= Do not use for operator form input of group names. 

, Do not use for short form or for operator form patterns. 

) Do not use for short form patterns. 

It is possibleto specify an ACL pattern using the @(file owner or group) or * (wildcard) symbols so that it 
cannot match certain files, perhaps depending on their ownership, by giving two entries, one with specific 
values and the other using @or *, which are equivalent for a file but contain different mode values. For 
example: 

find / -acl '(ajs.%r)(@%rw)' -print 

cannot match a file owned by ajs. 

DEPENDENCIES 

NFS NFS does not support acls on remote files. Individual manual entries specify the behavior of various 
system calls, library calls, and commands under these circumstances. Be careful when transferring a 
file with optional entries over a network or when manipulating a remote file because optional entries 
may be silently deleted. 
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AUTHOR 

The access control list design described here was developed by HP. 


FILES 

<sys/acl.h> 
<sys/getaccess .h> 
<acllib.h> 
/etc/passwd 
/etc/group 


Header file that supports setacl (2) and getacl (2). 
Header filethat supports getaccess(2). 

Header file that supports ACL library calls. 
Defines user names and user and group id values. 
Defines group names. 


SEE ALSO 

chacl(l), chmod(l), cp(l), find(l), getaccess(l), In(l), ls(l) : Isacl(l), mv(l), rm(l), fbackup(lM), frecover(lM), 
fsck(lM), fsdb(lM) access(2), chmod(2), chown(2), creat(2), getaccess(2), getacl(2), mknod(2), open(2), 
setacl(2), stat(2), acltostr(3C), chownacl(3C) : cpacl(3C) : setaclentry(3C) : strtoacl(3C), group(4), passwd(4) : 
privgrp(4). 


Section 5-10 


9 


HP-UX Release 11.0: October 1997 


aio(5) 


aio(5) 


NAME 

aio- POSIX asynchronous I/O facility 


SYNOPSIS 

#include <aio.h> 

DESCRIPTION 

The POSIX Asynchronous I/O facility implements Section 6.7 of IEEE Standard 1003.lb-1993, Standard for 
Information Technology, Portable Operating System Interface (POSIX), Part 1: System Application Pro¬ 
gram Interface (API), Amendment 1: Realtime Extensions (C Language). It allows a process (thread) to 
start multiple simultaneous read and/or write operations to multiple files, wait for or obtain notification of 
completion of requested operations, and to retrieve the status of completed operations. The purpose of the 
POSIX Asynchronous I/O facility is to allow a process (thread) to overlap some elements of computation and 
information processing with I/O processing. 


I nterface Functions 

The POSIX Asynchronous I/O facility includes thefollowing interface functions: 
aio_read () Start an asynchronous read operation 
aio_write () Start an asynchronous write operation 
lio_listio () Start a list of asynchronous I/O operations 
aio_suspend() 


Wait for completion of one or more asynchronous I/O operations 
aio_error () Retrieve the error status of an asynchronous I/O operation 

aio_return () Retrieve the return status of an asynchronous I/O operation and free any associated sys¬ 
tem resources 

aio_cancel () Request cancellation of a pending asynchronous I/O operation 

aio_fsync () Request synchronization of the media image of a file to which asynchronous operations 
have been addressed 

To use these functions, link in the realtime library by specifying -lrt on the compiler or linker command 
line. 


Asynchronous I/O Control Block 

The Asynchronous I/O Control Block (aiocb) is used as a parameter to all of the asynchronous I/O func¬ 
tions. The aiocb specifies parameters for an asynchronous I/O operation in a call to aio_read() , 
aio_write () , or lio_listio () and then may be used as a "handle! 1 for the enqueued asynchronous 
I/O operation in a subsequent call to aio_cancel() , aio_suspend (), aio_fsync(), 
aio_error () ,or aio_return() . 

The aiocb structure is defined in #include <aio . h> as: 


struct aiocb 
int 

off_t 

volatile 

size_t 

int 

struct 

int 

} ; 


{ /* IEEE Std 1003.1b, 
aio_fildes; /* 
aio_offset; /* 
void *aio_buf; /* 
aio_nbytes; /* 
aio_reqprio; /* 
sigevent aio_sigevent; /* 
aio_lio_opcode; /* 


Section 6.7.1.1 */ 
file descriptor */ 
file offset */ 
location of buffer */ 
length of transfer */ 
request priority offset */ 
signal number and value */ 
operation to be performed */ 


The aiocb supplied to aio_read() , aio_write() , or lio_listio() must contain the parame¬ 
ters that would be supplied in a normal synchronous read() or write () function call, where 
aio_fildes corresponds to fildes, aio_nbytes corresponds to nbytes, aio_offset 
corresponds to the implicit file offset. The aiocb may also contains request priority delta and signaling 
information to satisfy unique realtime and asynchronous I/O requirements. For the lio_listio () func¬ 
tion, the aio_lio_opcode field specifies whether the operation is a read or write. 

Once an asynchronous I/O operation has been enqueued for a particular aiocb its address is used as a 
handlefor other asynchronous I/O functions and can only be used to refer to a singleenqueued operation. 
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The fields aio offset64 pad, aio_return, aio_errno, and reserved are also defined in the 
aiocb structure but are reservered for future use and extension. They are all ignored by the asynchro¬ 
nous I/O facility. 

Manifest Constants 

Certain values as defined by the POSIX standard are declared in aio .h. 

The following values are returned by the aio_cancel () function: 

AlO_CANCELED All specified asynchronous I/O operations were successfully canceled. 

AIO_NOTCANCELED 

At least one specified asynchronous I/O operations was not successfully canceled. 

AlO_ALLDONE All specified asynchronous I/O operations were completed before the request was 
processed. 

The following values are valid values of the flags field that controls return from the lio_listio () 
function: 

LlO__WAlT Wait for all specified operations to complete. 

LlO_NOWAlT Return without waiting for operations to complete. 

The foil owing values are operation codes supplied in the aio_lio_opcode field the designate the type of 
an operation started with lio_listio () . 

LIO^READ The aiocb specifies an asynchronous read operation. 

LlO_WRlTE The aiocb specifies an asynchronous write operation. 

LlO_NOP The aiocb specifies no operation and is silently ignored. 

Enqueuing of Operations 

If an error condition is detected that prevents an operation from being started, aio_read() and 
aio_write () do not enqueue a request. Instead they immediately return -1 and set errno to indicate 
the cause of the failure. Once an operation has been successfully enqueued, calls to aio_error () and 
aio„return() referencing the aiocb referred to by aiocbp must be used to determine the status of 
the operation and any error conditions, including those normally reported by read() and write () . The 
request remains enqueued and consumes process and system resources until aio_return () is called. 

Error reporting of operations enqueued by lio_listio () may be less immediate than that of operations 
enqueued by aio_read() and aio_write() . With the exception of resource shortages, errors for 
which aio_read() and aio_write () would immediately return-1 and an errno value do not cause 
lio_listio () to stop enqueuing the current or subsequent requests in its list. I nstead, partial success 
occurs. In this case, the application must use aio_error() to determine which operations in its list 
have been enqueued and which resulted in errors. 

Asynchronous I/O operations are said to be complete when: 

• The I/O transfer is performed successfully. 

• An error is detected in one or more parameters of the operation. 

• The operation is canceled. If a valid sigevent is specified in the aiocb is used to start the 
operation, then the signal isdelivered when theoperation completes. 

Reading and Writing Asynchronously 

Asynchronous read and write operations are started using the aio_read() , aio_write() , and 
lio_listio () interfaces. The parameters for each operation are provided in the aiocb used to start 
the operation. A list of aiocb pointers can be provided to the lio_listio () function call, in which 
case the type (read or write) of the operation is determined from the aio_lio_opcode field of the 
aiocb. Once started, the I/O operations may proceed concurrently with execution of the process (thread) 
that initiated theoperation. 

With the implementation of process threads in the HP-UX implementation, an application may achieve 
asynchronous I/O behavior by using synchronous read() and write () functions from independent 
threads within the process. However, the application may have to implement many of the status manage¬ 
ment facilities provided in the POSIX Asynchronous I/O facility. 
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Waiting for Completion 

The POSIX Asynchronous I/O facility supports both polling and notification models. The polling model is 
implemented by repeatedly calling the aio_error () function to test the status of an operation. The 
notification model is implemented by designating a sigevent in the aiocb used to start the operation. 
The specified notification, if any, is then performed when the operation completes. 

The aio_suspend () function allows the application to wait for completion of one or more asynchronous 
I/O operations. A timeout may be set so that the process can again execute and take appropriate recovery 
actions if the expected operations do not complete as expected. If the aio_suspend () references multi¬ 
ple operations, return is made when any one of the operations completes. 

Retrieving Errors 

Once an asynchronous I/O operation has been started, its status can be tested with the aio_error () 
and aio_return() functions, which return the current status of a referenced aiocb. For a polling 
implementation, the aio_error () function is used to check the status until a completion status is seen, 
then aio_return ( ) is used to free the aiocb for re-use. 

For a notification implementation, status of the completed I/O can be determined and the aiocb freed 
with a single call to aio_return () . 

The errors reported by aio_error () and aio_return () include all of the errors normally reported 
byread() andwritef) plus errors unique to asynchronous I/O processing. After an asynchronous I/O 
operation is started but before an error is detected or the operation completes successfully, aio_error ( ) 
will return EINPROGRESS. 

Cancellation 

The aio_cancel () function allows an application to request cancellation of an asynchronous I/O opera¬ 
tion. The aiocb used to start the operation may be used as a handle to identify it for cancellation. Can¬ 
cellation of all operations pending for a file may also be requested. Not all asynchronous I/O operations can 
be canceled. 

Synchronizing Permanent Storage 

The aio_fsync() function supports synchronizing the contents of permanent storage when multiple 
asynchronous I/O operations are outstanding for the file or device. Only those requests already enqueued 
for the designated file at the time of the function call are included in the synchronization operation. 

File Offsets 

Asynchronous I/O operations are not inherently sequential. Each operation must specify an offset, and the 
file offset is never updated as a result of an asynchronous I/O operation. 

Although correct behavior is supported, it should be noted that setting the 0_APPEND flag on a file to 
which asynchronous I/O operations limits the value of asynchronous I/O. When 0_APPEND is set, opera¬ 
tions on the file must be handled serially with the ending file length after one request providing the starting 
offset for the next. While there may be some advantage to allowing the system to queue requests, care 
should betaken not to exhaust system or process thread resources by enqueuing a large number of requests 
that must be processed serially. 

System Limitations and Restrictions 

The operation of the POSIX Asynchronous I/O interfaces is subject to certain system limitations and res¬ 
trictions. 

Since each enqueued asynchronous I/O operation requires allocation of system memory for its internal con¬ 
trol structure, the number of simultaneously enqueued asynchronous I/O operations that the system can 
have pending is limited. The maximum number of asynchronous I/O operations that all active processes on 
the system may have enqueued concurrently is tunable. The current maximum value can be obtained using 
thesysconf() call with the argument _SC_AI0_MAX . The default maximum value is 2048. Inaddi¬ 
tion to the system-wide limit, there is a per-process limit. It is controlled using the argument 
RLIMIT_AIO_OPS to the getrlimit () and setrlimit () system calls. Even though an asynchro- 
nousl/O operation has completed, it still remains enqueued until aio_return () is called for that opera¬ 
tion. 

The asynchronous I/O operations which use request and call back mechanism for I/O, are subject to a 
system-wide limit on the amount of physical memory that can be locked during asynchronous I/O transfers. 
This system-wide maximum number of bytes of memory that can be locked simultaneously for aio requests 
is tunable. This can be set as a percentage of the physical memory availableon the system. By default, it is 
set to 10% of the physical memory. I n addition to the system-wide limit, there is a per-process limit which 
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is controlled using the argument RLIMIT_AI0_MEM to the getrlimit () and setrlimit () system 
calls. Further, the amount of memory that can be locked at a time for any reason, not just for asynchronous 
I/O, is controlled by the system-wide limit lockable_mem. Other system activity, including explicit 
memory locking with plock () and/or mlock () interfaces may affect the amount of lockable memory at 
any given time. 

The maximum priority change that can be specified in aio_reqprio is limited. The maximum priority 
change value is tunable. The current maximum value can be obtained using the sysconf () call with the 
argument _SC_AI0_PRI0_DELTA_MAX. The default value is 20. 

The maximum number of asynchronous I/O operations that can be specified in a single lio_listio () 
call is limited. This limit is tunable. The current maximum value can be obtained using the sysconf () 
call with the argument _SC_AI0_LISTI0_MAX. The default maximum value is 256. 

Some asynchronous I/O operations are also subject to both system-wide and per-process limits on the 
number of simultaneously active threads. See pthread(3T). 

Programming Limitations and Restrictions 

Altering the contents of or deallocating memory associated with the aiocb referred to by aiocbp or the 
buffer referred to by aiocbp->aio_buf while an asynchronous read operation is outstanding, that is 
aio_return () has not been called for the aiocb, may produce unpredictable results. 

EXAMPLES 

The following code sequence illustrates an asynchronous read operation and polling for completion. 

#include <fcntl.h> 

#include <errno.h> 

#include <aio.h> 
char buf[4096]; 
int retval; 
struct aiocb myaiocb; 

bzero ( Smyaiocb, sizeof (struct aiocb)); 

myaiocb.aio_fildes = open( "/dev/null", 0_RD0NLY); 

myaiocb.aio_offset = 0; 

myaiocb.aio_buf = (void *) buf; 

myaiocb.aio_nbytes = sizeof (buf); 

myaiocb.aio_sigevent.sigev_notify = SIGEV_NONE; 

retval = aio_read( Smyaiocb ); 

if (retval) perror ("aio:"); 

/* continue processing */ 

/* wait for completion */ 

while ( (retval = aio_error( Smyaiocb) ) == EINPROGRESS) ; 

/* free the aiocb */ 

retval = aio_return( Smyaiocb); 

SEE ALSO 

aio_cancel(2), aio_error(2), aio_fsync(2), aio_read(2), aio_return(2), aio_suspend(2), aio_write(2), fda- 
tasync(2), fsync(2), getrlimit(2), lio_listio(2), read(2), setrlimit(2), write(2), pthread(3T). 

STANDARDS CONFORMANCE 

aio: POSIX Realtime Extensions, IEEE Std 1003.1b 
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NAME 

aliases - aliases file for sendmail 

SYNOPSIS 

aliases 

DESCRIPTION 

This file describes user ID aliases used by /usr/sbin/sendmail. The file resides in /etc/mail and 
isformatted asa series of lines of the form 

name: namel, name2, name3, . . . 

The name is the name to alias, and the namen are the aliases for that name. Lines beginning with white 
space are continuation lines. Lines beginning with #are comments. 

Aliasing occurs only on local names. Loops can not occur, since no message will be sent to any person more 
than once. 

After aliasing has been done, local and valid recipients who have a . forward file in their home directory 
have messages forwarded to the list of users defined in that file. 

This is only the raw data file; the actual aliasing information is placed into a binary format in the file 
/etc/mail/aliases . db using the program newaliases(l). A newaliases command should be exe¬ 
cuted each time the aliases file is changed for the change to take effect. Note that the NIS alias maps are 
generated by ypmake using the makemap program, which leaves aliases.pagand aliases.dir in the/etc/mail 
directory. 

SEE ALSO 

newaliases(lM), sendmail(lM). 

HISTORY 

The aliases file format appeared in 4.0BSD. 
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NAME 

ascii - map of ascii character set 

SYNOPSIS 

cat /usr/share/lib/pub/ascii 

DESCRIPTION 

/usr/share/lib/pub/ascii provides a map of theASCll character set, giving both octal and hexa¬ 
decimal equivalents of each character, to be printed as needed. The file contains the foil owing text: 


| 000 

nul 

| 001 

soh 

| 002 

stx 

| 003 

etx 

| 004 

eot 

| 005 

enc 

| 006 

ack 

| 007 

bel| 

| 010 

bs 

| Oil 

ht 

| 012 

nl 

|013 

vt 

| 014 

np 

| 015 

cr 

| 016 

so 

| 017 

si | 

| 020 

die 

| 021 

del 

| 022 

dc2 

| 023 

dc3 

| 024 

dc4 

| 025 

nak 

| 026 

syn 

| 027 

etb | 

| 030 

can 

|031 

em 

|032 

sub 

|033 

esc 

|034 

f s 

| 035 

gs 

| 036 

rs 

|037 

us | 

| 040 

sp 

| 041 

i 

| 042 

" 

| 043 

# 

| 044 

$ 

| 045 

% 

| 046 

& 

| 047 

' 1 

| 050 

( 

| 051 

) 

| 052 

★ 

|053 

+ 

| 054 

r 

| 055 

- 

| 056 


|057 

/ i 

| 060 

0 

| 061 

1 

| 062 

2 

| 063 

3 

| 064 

4 

|065 

5 

I 066 

6 

| 067 

7 1 

| 070 

8 

| 071 

9 

| 072 


|073 

’ 

| 074 

< 

| 075 

= 

| 076 

> 

| 077 

? 1 

1100 

0 

1101 

A 

1102 

B 

1103 

c 

1104 

D 

1105 

E 

1106 

F 

1107 

G | 

1110 

H 

1 HI 

I 

1112 

J 

|113 

K 

1114 

L 

1 H5 

M 

1116 

N 

1117 

0 | 

1120 

P 

1121 

Q 

1122 

R 

1123 

S 

1124 

T 

1125 

U 

1126 

V 

1127 

W 1 

1130 

X 

|131 

Y 

|132 

Z 

|133 

[ 

|134 

\ 

|135 

] 

|136 


|137 


1140 


1141 

a 

1142 

b 

1143 

c 

1144 

d 

1145 

e 

1146 

f 

1147 

g 1 

1150 

h 

1151 

i 

1152 

j 

|153 

k 

1154 

1 

1155 

m 

1156 

n 

|157 

O 1 

1160 

P 

1161 

q 

1162 

r 

1163 

s 

1164 

t 

|165 

u 

1166 

V 

1167 

w I 

1170 

X 

1171 

y 

1172 

z 

|173 

{ 

1174 

1 

1175 

} 

1176 


1177 

del| 

| 00 

nul 

1 01 

soh 

| 02 

stx 

| 03 

etx 

| 04 

eot 

1 05 

enc 

| 06 

ack 

| 07 

bel| 

| 08 

bs 

| 09 

ht 

| 0a 

nl 

| 0b 

vt 

| 0c 

np 

| Od 

cr 

| Oe 

so 

1 Of 

si | 

1 10 

die 

1 11 

del 

1 12 

dc2 

1 13 

dc3 

1 14 

dc4 

1 15 

nak 

1 16 

syn 

1 17 

etb | 

1 18 

can 

1 19 

em 

1 la 

sub 

1 lb 

esc 

1 1c 

f s 

1 Id 

gs 

1 la 

rs 

1 If 

us | 

| 20 

sp 

1 21 

i 

| 22 

" 

| 23 

# 

| 24 

$ 

1 25 

% 

| 26 

& 

| 27 

' 1 

| 28 

( 

| 29 

) 

| 2a 

★ 

| 2b 

+ 

1 2c 

f 

| 2d 

- 

1 2e 


1 2f 

/ i 

| 30 

0 

1 31 

1 

| 32 

2 

| 33 

3 

1 34 

4 

1 35 

5 

1 36 

6 

| 37 

7 1 

| 38 

8 

| 39 

9 

1 3a 


1 3b 

; 

1 3c 

< 

1 3d 

= 

1 3e 

> 

1 3f 

? 1 

| 40 

0 

1 41 

A 

1 42 

B 

1 43 

C 

| 44 

D 

1 45 

E 

| 46 

F 

1 47 

G | 

| 48 

H 

| 49 

I 

1 4a 

J 

| 4b 

K 

| 4c 

L 

| 4d 

M 

| 4e 

N 

1 4f 

0 | 

1 50 

P 

1 51 

Q 

1 52 

R 

1 53 

S 

1 54 

T 

1 55 

U 

1 56 

V 

1 57 

W 1 

1 58 

X 

1 59 

Y 

1 5a 

Z 

1 5b 

[ 

1 5c 

\ 

1 5d 

] 

1 5e 

- 

1 5f 


| 60 


1 61 

a 

| 62 

b 

1 63 

c 

| 64 

d 

1 65 

e 

| 66 

f 

1 67 

g 1 

| 68 

h 

| 69 

i 

| 6a 

j 

| 6b 

k 

| 6c 

1 

| 6d 

m 

| 6e 

n 

1 6f 

O 1 

| 70 

P 

1 71 

q 

| 72 

r 

| 73 

s 

1 74 

t 

1 75 

u 

1 76 

V 

| 77 

w I 

| 78 

X 

| 79 

y 

1 7a 

z 

1 7b 

{ 

1 7c 

1 

1 7d 

} 

1 7e 

~ 

1 7f 

del| 


Control Characters 

The following table shows the set of ascii control characters with their octal, decimal, and hexadecimal 
values. To obtain the respective characters from the keyboard, use the indicated keypress combinations. 

To place control characters in a file when using the vi or ex editor, typeCtrl-v before typing the desired 
control character. 
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Oct 

Dec 

Hex 

Disp 

Symbol 

Char Name 

Keypress 

000 

000 

00 

none 

NUL 

Null 

Ctrl-Shift-@ 

001 

001 

01 


SOH 

Start of Header 

Ctrl-A 

002 

002 

02 


STX 

Start of Text 

Ctrl-B 

003 

003 

03 

A c 

ETX 

E nd of Text 

Ctrl-C 

004 

004 

04 


EOT 

End of Transmission 

Ctrl-D 

005 

005 

05 


ENQ 

Enquire 

Ctrl-E 

006 

006 

06 


ACK 

Acknowledge 

Ctrl-F 

007 

007 

07 


BEL 

Bell 

Ctrl-G 

010 

008 

08 


BS 

Back Space 

Ctrl-H 

Oil 

009 

09 


HT 

Horizontal Tab 

Ctrl-I 

012 

010 

0A 


LF 

Line Feed 

Ctrl-J 

013 

Oil 

0B 


VT 

Vertical Tab 

Ctrl-K 

014 

012 

OC 


FF 

Form Feed 

Ctrl-L 

015 

013 

0D 


CR 

Carriage Return 

Ctrl-M 

016 

014 

0E 


SO 

Shift Out 

Ctrl-N 

017 

015 

OF 

"O 

SI 

Shift 1 n 

Ctrl-0 

020 

016 

10 


DLE 

(or DEL) Delete 

Ctrl-P 

021 

017 

11 

"Q 

DC1 

Device Control 1 

Ctrl-Q 

022 

018 

12 


DC2 

Device Control 2 

Ctrl-R 

023 

019 

13 


DC3 

Device Control 3 

Ctrl-S 

024 

020 

14 


DC4 

Device Control 4 

Ctrl-T 

025 

021 

15 


NAK 

N egati ve Acknowl edge 

Ctrl-U 

026 

022 

16 

A v 

SYN 

Synchronize 

Ctrl-V 

027 

023 

17 


ETB 

End Transmission Block 

Ctrl-W 

030 

024 

18 


CAN 

Cancel 

Ctrl-X 

031 

025 

19 


EM 

E nd of M edi um 

Ctrl-Y 

032 

026 

1A 


SUB 

Substitute 

Ctrl-Z 

033 

026 

1A 


ESC 

Escape 

Ctrl- [ 

034 

026 

1A 

*\ 

FS 

File Separator 

CtrlA 

035 

026 

1A 

'] 

GS 

Group Separator 

Ctrl-] 

036 

026 

1A 


RS 

Record Separator 

C trl-Shift-~ 

037 

026 

1A 


US 

Unit Separator 

Ctrl-Shift- 

177 

127 

7F 

~ ? 

DEL 

Del ete 

DEL 


WARNINGS 

Note that some hp-ux subsystems such as the keyboard interface, window systems, and other system 
software may use selected keyboard control characters for special purposes, possibly causing unexpected 
results. 


FILES 

/usr/share/lib/pub/ascii 
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NAME 

Audio- audio tools availablethrough HP VUE 

DESCRIPTION 

This man-page describes the audio tools availablethrough HP VUE for playing, recording, and editing 
sound. These include Audio Setup, Audio Security, Audio Editor, Audio Control Panel, Audio File and Data 
Formats, and Audio Library. Audio(5) also provides information on using other audio tools from the HP- 
UX command line. 

Audio Setup Requirements 

To use the audio tools, you need access to both audio client and server software. This software is part of 
HP-UX. The server requires a workstation or X station with Audio hardware. 

Audio hardware is built into all Series 700 computers e<cept the 720, 730, and 750; you can upgrade these 
models to become the 725, 735, or 755, which do have audio hardware. Note, older 705s (that is, 705s with 
the 8MB HP-UX) do not include audiosoftware. 

Touseaudioon an X station, you need either an HP ENVIZEX or ENTRIA X station that includes an audio 
accessory kit. 

In most cases, you use the audio client and server software on one system. However, if you need the audio 
server running on a remote workstation or X station, see aserver(lM). The audio data files can reside on 
either system or a third system. 

Audio Security 

Audio is secured to allow access only to the user on the local workstation. If you need to allow remote sys¬ 
tems to access audio on a workstation, see asecure(lM). 

The Audio Editor 

The Audio Editor is an OSF/Motif-based tool with play, record, and edit functions. The Editor displays a 
waveform that makes it easy to edit and play audio segments. 

You can open an audio file, play it, look at its waveform, and use the waveform controls to edit the file. To 
set an output device, use the Audio Control Panel. 

To record audio, first connect a microphone or other audio equipment that your system supports; perhaps a 
CD or tape player. To make the connections, see the Audio Editor online help ('Audio Editor Tasks" section) 
or your system owner's manual. 

You can use the Editor to create and record an audio file. 

To start the Editor from the General Toolbox, open the Media Toolbox and drop an audio file on 
the Audio Editor control or double-click the control. 

To start the Editor in a terminal window, type the following: 
/opt/audio/bin/audio_editor [pathname] 

Online help is availablethrough the Help menu in the upper-right hand corner of the Editor. 

The Audio Control Panel 

The Audio Control Panel is an OSF/Motif-based tool that you use to set the audio volume and choose the 
audio device for playback. 

The volume control affects the play volume for any client system of this workstation or X station. The 
Audio Control Panel also includes a Stop button to stop the current play operation. 

You can also use the Audio Control Panel to choose the device for playback, (headphones, built-in speaker, 
or device connected to Line Out, such as external speakers). This choice controls where audio is played 
when you double-click an audio file or use the Audio Editor to play a file. The default output device is the 
internal (built-in) speaker. 

To start the Audio Control Panel from HP VUE, click on the Audio control in HP VUE Front 
Panel. 

To start the Audio Control Panel in a terminal window, typethefollowing: 

/opt/audio/bin/AudioCP 

If your system has Audio applications that were developed using an earlier version of Audio software, those 
applications may use the SPEAKER environment variableto determine their output devices. You can set 
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the SPEAKER variablefor all applications started by HP VUE by modifying the $HOME/. vueprofile 
file. The SPEAKER variablecan be external (headphones, LineOut)or internal (built-in speaker). 

To set the SPEAKER variablefor a Bourne or Korn shell, enter: 

SPEAKER=internal 
export speaker 

To set the SPEAKER variablefor a C shell, enter: 

setenv SPEAKER internal 

Audio File and Data Formats 

Audio files supported contain uncompressed audio data in one of three file formats: generic, 
Rl FF/Waveform, or raw. Each file also needs the correct filename extension. For the three file formats, 
the Audio Editor online help lists which data formats and filename extensions that apply. 

The extension causes the appropriate icon to appear in the File Manager. To play audio files you can drag 
and drop the file icons onto the Audio Editor or Control Panel or double-click the icon. 

If you need to add an extension to a filename, (or convert the file format) the 
/opt/audio/bin/convert command is recommended. See convert(l). However, you can instead 
rename the file to make it playable. Use this filename format: 

filename. rate.data_type 

The rate and data type variables accept values defined for the -drate and -ddata options of con¬ 
vert. If needed, you can omit the rate variable. Use thisfilename format: 

filename.data_type 

Audio Library 

HP-UX includes an Audio Library that was used to build the audio tools. If you have ordered and installed 
the User Environment Developer's Kit, you can use the Audio Library to create other audio applications. 

The HP-UX Audio Library contains functions that C programs can use to manipulate audio. The functions 
interact with the Audio Server, enabling the application to record and play audio data files and convert 
audio data files from one format to another. 

For more information about audio programming, refer to the manual Using theAudio De/eloper's Kit. 

AUTHOR 

The Audio Library, Audio Editor, and Audio Control Panel were developed bytip. 

SEE ALSO 

asecure(lM), aserver(lM), attributes(l), convert(l), send_sound(l). 

Using theAudio Developer's Kit 
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NAME 

audit - introduction to HP-UX Auditing System 

SYNOPSIS 

include <sys/audit.h> 

DESCRIPTION 

The purpose of the auditing system is to record instances of access by subjects to objects and to allow detec¬ 
tion of any (repeated) attempts to bypass the protection mechanism and any misuses of privileges, thus act¬ 
ing as a deterrant against system abuses and exposing potential security weaknesses in the system. 

User and Event Selection 

The auditing system provides administrators with a mechanism to select users and activities to be audited. 
Users are assigned unique identifiers called audit ids by the administrator which remain unchanged 
throughout a user's history. Theaudusr(lM) command is used to specify those users who are to be audited. 
The audevent(lM) command is used to specify system activities (auditable events) that are to be audited. 
Audi table events are classified into several categories, illustrated by the event category list at the end. (An 
event category consists of a set of operations that affect a particular aspect of the system.) 

Self-auditing Programs 

To reduce the amount of log data and to provide a higher-level recording of some typical system operations, 
a collection of privileged programs are given capabilitiesto perform self-auditing. This means that the pro¬ 
grams can suspend the currently specified auditing on themselves and produce a high-level description of 
the operations they perform. These self-auditing programs include: at(l), chfn(l), chsh(l), crontab(l), 
login(l), newgrp(l), passwd(l), audevent(lM), audisp(lM), audsys(lM), audusr(lM), cron(lM), init(lM), 
Ipsched(lM), pwck(lM), and sam(lM). Note that only these privileged programs are allowed to do self¬ 
auditing, and that the audit suspension they perform only affects these programs and does not affect any 
other processes on the system. 

Viewing of Audited Data 

The audisp(lM) command is used to view audited data recorded in log file(s). audisp(lM) merges the log 
file(s) into a single audit trail in chronological sequence. The administrator can select viewing criteria pro¬ 
vided by audisp(lM) to limit the search to particular kinds of events which the administrator is interested 
in investigating. 

Monitoring the Auditing System 

To ensure that the auditing system operates normally and that any abnormal behaviors are detected, a 
privileged daemon program, audomon(lM), runs in the background to monitor various auditing system 
parameters. When these parameters take on abnormal (dangerous) values, or when components of the 
auditing system are accidentally removed, audomon(lM) prints warning messages and tries to resolve the 
problem if possible. 

Starting and Halting the Auditing System 

The administrator can use the audsys(lM) command to start or halt the auditing system, or to get a brief 
summary of the status of the audit system. Prior to starting the auditing system, audsys(lM) also validates 
the parameters specified, and ensures that the auditing system is in a safe and consistent state. 

Audit Log Files 

At any time when the auditing system is enabled, at least an audit log file must be present, and another 
back-up log file is highly recommended. Both of these files (along with various attributes for these files) can 
be specified using audsys(lM). When the current log file exceeds a pre-specified size, or when the auditing 
file system is dangerously full, the system automatically switches to the back-up file if possible. If a back¬ 
up log file is not available, warning messages are sent to request appropriate administrator action. 

Event Categories 

create Log creations of objects (files, directories, other objects), including creat(2), mkdir(2), 
mknod(2), msgget(2), pipe(2), semget(2), shmat(2), and shmget(2). 

delete Log all deletions of objects (files, directories, other objects), including ksem_unlink(2), 
mq_unlink(2), msgctl (2), rmdir(2), semctl (2), and shm_unlink(2). 

readdac Log reads of Discretionary access control (DAC) information including access(2), 
fstat(2), fstat64(2), getaccess(2), lstat(2), Istat64(2), stat(2), stat64(2). 
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moddac 

modaccess 

open 

close 

process 

removable 

login 

admin 


ipccreat 

ipcopen 

ipcclose 

ueventl 

uevent2 

uevent3 

ipcdgram 


Log all modifications of object's Discretionary access control (DAC) information includ¬ 
ing chmod(2), chown(2), fchmod(2), fchown(2), fsetacl (2), setacl (2), and umask(2). 

Log all modifications other than DAC, including chdir(2), chroot(2), Iink(2), lockf64(2), 
newgrp(l), rename(2), setgid(2), setgroups(2), setresgid(2), setresuid(2), setuid(2), 
shmctl (2), shmdt(2), and unlink(2). 

Log all openings of objects (file open, other objects' open) including o<ecv(2), e<ecve(2), 
ftruncate(2), ftruncate64(2), kload(2), ksem_open (2), Ipsched(lM), mmap64(2), 
mq_open(2), open(2), ptrace(2), shm_open(2), truncate(2), and truncate64(2). 

Log all closings of objects (file close, other objects' close) including dose(2), 
ksem_close(2), and mq_close(2). 

Log all operations on processes, including e<it(2), fork(2), kill(2), mlock(2), mlock- 
al I (2), munlock(2), munlockall (2), setcontext(2), setrlimit64(2), sigqueue(2), 
ulimit64(2), and vfork(2). 

Log all removable media events (mounting and unmounting events), including 
mount(2), umount(2), and vfsmount(2). 

Log all logins and logouts, including login(l), init(lM). 

Log all administrative and privileged events, including audevent(lM), audisp(lM), 
audswitch(2), audsys(lM), audusr(lM), chfn(l), chsh(l), init(lM), passwd(l), 
pwck(lM), reboot(2), sam(lM), setaudid(2), setaudproc(2), setdomainname(2), 
setevent(2), sethostid(2), settimeofday(2), stime(2), and swapon(2). 

Log all I PC create events including socket(2) and bind(2). 

Log all I PC open events including connect(2) and accept(2). 

Log all I PC close events including shutdown(2). 

Log user-defined event. 

Log user-defined event. 

Log user-defined event. 

Log I PC Datagram transactions. 


For a complete description of system call assignmentsto event types, see audevent(lM). 


Note that some commands such as init(lM) may occur in more than one category because the event varies, 
depending on the operation done by the command. 


AUTHOR 

The auditing system described above was developed by PIP. 


SEE ALSO 

audsys(lM), audusr(lM), audevent(lM), audisp(lM), audctl(2), audswitch(2), audwrite(2), getaudid(2), 
setaudid(2), getevent(2), setevent(2), audit(4). 
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NAME 

curses.h — definitions for screen handling and optimisation functions 

SYNOPSIS 

#include <curses.h> 

DESCRIPTION 

Objects 

The -courses.h> header provides a declaration for COLORPAIRS, COLORS, COLS, curscr, LINES 
and stdscr. 

Constants 

The foil owing constants are defined: 

EOF Function return valuefor end-of-file 

ERR Function return valuefor failure 

FALSE Boolean falsevalue 

OK Function return valuefor success 

TRUE Boolean true value 

WEOF Wide-character function return valuefor end-of-file, as defined in cwchar .h>. 

Data Types 

The foil owing data types are defined through typedef: 
attr_t An OR-ed set of attributes 

bool Boolean data type 

chtype A character, attributes and a colour-pair 
SCREEN An opaque terminal representation 
wchar_t As described in <stddef.h> 
wint_t As described in <wchar.h> 
cchar_t References a string of wide characters 
WINDOW An opaque window representation 

These data types are described in more detail in Data Types in cursesjntro. 

The inclusion of courses . h> may make visible all symbols from the headers <stdio .h>, cterm. h>, 
<termios.h> and cwchar.h>. 


Attribute Bits 

The foil owing symbolic constants are used to mani pul ate objects of type attr_t: 


WA_ALTCHARSET 
WABLINK 
WA BOLD 
WA_DIM 

WA_HORIZONTAL 

WA_I NVIS 

WA_LEFT 

WALOW 

WA_PROTE CT 

WA_REVERSE 

WA_RIGHT 

WA_STANDOUT 

WA_TOP 

WAUNDERLINE 

WA_VE RTI CAL 


Alternate character set 
Blinking 

Extra bright or bold 
Flalf bright 
Fiorizontal highlight 
I n visible 
Left highlight 
Low highlight 
Protected 
Reverse video 
Right highlight 

Best highlighting mode of the terminal 
Top highlight 
Underlining 
Vertical highlight 


These attribute flags shall be distinct. 
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The foil owing symbolic constants are used to manipulate attribute bits in objects of type chtype: 


A_ALTCHARSET 

ABLINK 

A BOLD 

A_DIM 

A_l NVIS 

A_PROTECT 

A_REVERSE 

A_STANDOUT 

AUNDERLINE 


Alternate character set 
Blinking 

Extra bright or bold 
Half bright 
I n visible 
Protected 
Reverse video 

Best highlighting mode of the terminal 
Underlining 


These attribute flags need not be distinct except when _XOPEN_CURSES is defined and the application 
sets XOPEN SOURCE EXTENDED to 1. 


The foil owing symbolic constants can be used as bit-masks to extract the components of a chtype: 

A_ATTRIBUTES Bit-mask to extract attributes 

A_CHARTEXT Bit-mask to extract a character 

A_COLOR Bit-mask to extract colour-pair information 

The foil owing symbolic constants can be used as bit-masks to extract the components of a chtype: 


A_ATTRI BUTE S 

A_CHARTEXT 

A_COLOR 


Bit-mask to extract attributes 
Bit-mask to extract a character 
Bit-mask to extract colour-pair information 


Line-Drawing Constants 

The <curses. h> header defines the symbolic constants shown in the leftmost two columns of the follow¬ 
ing table for use in drawing lines. The symbolic constants that begin with ACS_ are char constants. The 
symbolic constants that begin with WACS_ are cchar_t constants for use with the wide-character inter¬ 
faces that take a poi nter to a cchar_t. 

In the POSIX locale, the characters shown in the POSIX Locale Default column are used when the terminal 
database does not specify a value using the acsc capability as described in LineGraphics in terminfo(4). 


POSIX Locale 


char Constant 

cchar t Constant 

Default 

Glyph Description 

AC S_ULCORNER 

WACS_ULCORNER 

+ 

upper left-hand corner 

ACS_LLCORNER 

WACS_LLCORNER 

+ 

lower left-hand corner 

AC S_URCORNER 

WACS_URCORNER 

+ 

upper right-hand corner 

AC S_LRCORNER 

WACS_LRCORNER 

+ 

lower right-hand corner 

ACS_RTEE 

WACS_RTEE 

+ 

right tee (-|) 

ACS_LTEE 

WACS_LTEE 

+ 

left tee (|-) 

ACS_BTEE 

WACS_BTEE 

+ 

bottom tee Q) 

ACS_TTEE 

WACS_TTEE 

+ 

top tee (J) 

ACS_HLINE 

ACS_VLINE 

WACS_HLINE 

WACS_VLINE 

1 

horizontal line 
vertical line 

ACS_PLUS 

WACS_PLUS 

+ 

plus 

ACS_S1 

WACS_S1 

- 

scan line 1 

ACS_S9 

WACS_S9 


scan line9 

AC S_DIAMOND 

WAC S_DIAMOND 

+ 

diamond 

AC S_CKBOARD 

WAC S_CKBOARD 


checker board (stipple) 

ACS_DEGREE 

WAC S_D E GRE E 

' 

degree symbol 

ACS_PLMINUS 

WACS_PLMINUS 

# 

plus/minus 

ACS_BULLET 

WACS_BULLET 

O 

bullet 

ACS_LARROW 

WACS_LARROW 

< 

arrow pointing left 

AC S_RARROW 

WAC S_RARROW 

> 

arrow pointing right 

ACS_DARROW 

WACS_DARROW 

V 

arrow poi nti ng down 

ACS_UARROW 

WACS_UARROW 

A 

arrow pointing up 

ACS_BOARD 

WAC S_BOARD 

# 

board of squares 

ACS_LANTERN 

WAC S_LAN T E RN 

# 

lantern symbol 

ACS_BLOCK 

WACS_BLOCK 

# 

solid square block 
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Col our-related Macros 

The foil owing colour-related macros are defined: 

COLORBLACK 

COLORBLUE 

COLORGREEN 

COLOR_CYAN 

COLORRED 

COLORMAGENTA 

COLORYELLOW 

COLORWHITE 

Coordinate-related Macros 

The foil owing coordinate-related macros are defined: 

void getbegyx (WINDOW *win, int y, 

void getmaxyx (WINDOW *win, int y, 

void getparyx (WINDOW *win, int y, 

void getyx (WINDOW *win, int y, int 


int X) ; 
int X) ; 
int X) ; 
X) ; 
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Key Codes 

The foil owing symbolic constants representing function key values are defined: 


Key Code 

KEYCODEYES 

KEYBREAK 

KEY_DOWN 

KE YU P 

KEYLEFT 

KEYRIGHT 

KEYHOME 

KEYBACKSPACE 

KEYFO 

KEY_F(n) 

KEYDL 

KEYIL 

KEYDC 

KEYIC 

KEYEIC 

KEY_CLEAR 

KEYEOS 

KEYEOL 

KEYSF 

KEYSR 

KEYNPAGE 

KEYPPAGE 

KEYSTAB 

KEYCTAB 

KEYCATAB 

KEYENTER 

KEYSRESET 

KEYRESET 

KEYPRINT 

KEYLL 

KEYAl 

KEYA3 

KEYB2 

KEY_C1 

KEY C3 


Description 

Used to indicate that a wchar_t variablecontainsa key code 

Break key 

Down arrow key 

Up arrow key 

Left arrow key 

Right arrow key 

H ome key 

Backspace 

Function keys; space for 64 keys is reserved 

For 0<n<63 

Delete line 

Insert line 

Delete character 

I nsert char or enter insert mode 

Exit insert char mode 

Clear screen 

Clear to end of screen 

Clear to end of line 

Scroll 1 line forward 

Scroll 1 line backward (reverse) 

Next page 
Previous page 
Set tab 
Clear tab 
Clear all tabs 
E nter or send 
Soft (partial) reset 
Reset or hard reset 
Print or copy 
FI ome down or bottom 
Upper left of keypad 
Upper right of keypad 
Center of keypad 
Lower left of keypad 
Lower right of keypad 


The virtual keypad isa 3-by-3 keypad arranged as follows: 


Al 

UP 

A3 

LEFT 

B2 

RIGHT 

Cl 

DOWN 

C3 


Each legend, such as Al, corresponds to a symbolic constant for a key code from the preceding table, such 
as KEY_A1. The foil owing symbolic constants representing function key values are also defined: 


Key Code 

KEY B1A3 

KEYBEG 

KEYCANCEL 

KEYCLOSE 

KEY_COMMAND 

KEYCOPY 

KEYCREATE 

KEY_END 

KEYEXIT 

KEY_FI N D 

KEYHELP 

KEYMARK 

KEYMESSAGE 

KEY MOVE 


Back tab key 
Beginning key 
Cancel key 
Close key 

Cmd (command) key 
Copy key 
Create key 
E nd key 
Exit key 
Find key 
H el p key 
Mark key 
M essage key 
M ove key 


Description 
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KEYNEXT 

KEYOPEN 

KEYOPTIONS 

KEYPREVIOUS 

KEYREDO 

KEYREFERENCE 

KEYREFRESH 

KEYREPLACE 

KEYRESTART 

KEYRESUME 

KEYSAVE 

KEYSBEG 

KEYSCANCEL 

KEY_SCOMMAND 

KEYSCOPY 

KEYSCREATE 

KEYSDC 

KEYSDL 

KEYSELECT 

KEYSEND 

KEYSEOL 

KEYSEXIT 

KEYSFIND 

KEY_SHELP 

KEY_SHOME 

KEYSIC 

KEYSLEFT 

KEYSMESSAGE 

KEYSMOVE 

KEYSNEXT 

KEYSOPTIONS 

KEYSPREVIOU S 

KEYSPRI NT 

KEYSREDO 

KEYSREPLACE 

KEY_SRIGHT 

KEY_SRSUME 

KEYSSAVE 

KEYSSUSPEND 

KEYSUNDO 

KEYSUSPEND 

KEY UNDO 


Next object key 
Open key 
Options key 
Previous object key 
Redo key 
Reference key 
Refresh key 
Replace key 
Restart key 
Resume key 
Save key 

Shifted beginning key 
Shifted cancel key 
Shifted command key 
Shifted copy key 
Shifted create key 
Shifted delete char key 
Shifted delete linekey 
Select key 
Shifted end key 
Shifted clear linekey 
Shifted exit key 
Shifted find key 
Shifted help key 
Shifted home key 
Shifted input key 
Shifted left arrow key 
Shifted message key 
Shifted move key 
Shifted next key 
Shifted options key 
Shifted prev key 
Shifted print key 
Shifted redo key 
Shifted replace key 
Shifted right arrow 
Shifted resume key 
Shifted save key 
Shifted suspend key 
Shifted undo key 
Suspend key 
U ndo key 


Function Prototypes 

The foil owing are declared as functions, and may also be defined as macros: 

int addch(const chtype ch) ; 

int addchstr (const chtype *chstr) ; 

int addchnstr (const chtype *chstr, int n) ; 

int addnstr (const char *Str, int n) ; 

int addstr (const char *Str) ; 

int addnwstr (const wchar_t *WStr, int n) ; 

int addwstr (const wchar_t *WStr) ; 

int add wch(const cchar_t *WCh); 

int add wchnstr (const cchar_t *wchstr, int n) ; 

int add wchstr (const cchar_t *wchstr) ; 

int attroff(int attrs) ; 

int attron(int attrs); 

int attrset (int attrs) ; 

int attr_get (attr_t *attrs, short *Color_pair, void *opts) ; 
int attr_off (attr_t attrs, void *opts) ; 
int attr_on (attr_t attrs, void *opts) ; 

int attr_set (attr_t attrs, short color pair, void *opts) ; 
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int baudrate(void) ; 

int beep(void); 

int bkgd(chtype Ch) ; 

void bkgdset(chtype Ch) ; 

void bkgrndset(const cchar_t *WCh); 

int bkgrnd(const cchar_t *WCh) ; 

int border (chtype Is, chtype rs, chtype tS, chtype bs, chtype tl, 
chtype tr, chtype bl , chtype br) ; 
int border_set (const cchar_t *ls, const cchar_t *TS, 
const cchar_t *tS, const cchar_t *bs, 
const cchar_t *tl , const cchar_t *tr, 
const cchar_t *bl, const cchar_t *br) ; 
int box (WINDOW *win, chtype verch, chtype horch) ; 
int box_set (WINDOW *win, const cchar_t *verch, 
const cchar_t *horch) ; 
bool can_change_color(void); 

int cbreak(void); 

int chgat (int n, attr_t attr, short color, const void *0ptS) ; 
int clear(void); 

int clearok (WINDOW *win, bool bf) ; 

int clrtobot(void); 

int clrtoeol(void); 

int color_content (short color, short *red, short *green, 
short *blue) ; 

int COLOR_PAIR (int n); 

int copywin(const window *srcwin, window *dstwin, int sminrow, 
int smincol, int dminrow, int dmincol, int dmaxrow, 
int dmaxcol, int overlay); 
int curs_set (int visibility); 

int def_prog_mode(void); 

int def_shell_mode(void); 

int delay_output(int ms) ; 

int delch(void); 

void delscreen (SCREEN *sp) ; 

int delwin (WINDOW *win); 

int deleteln(void); 

window *derwin (window *orig, int nlines, int ncols, int begin_y, 
int begin_x) ; 
int doupdate(void); 

WINDOW *dupwin (WINDOW *win); 

int echo(void); 

int echochar(const chtype Ch) ; 

int echo_wchar(const cchar_t *WCh); 

int endwin(void); 

int erase(void); 

char erasechar(void); 

int erasewchar(wchar_t *ch) ; 

void filter(void); 

int flash(void); 

int flushinp(void); 

chtype getbkgd (WINDOW *win); 

int getbkgrnd(cchar_t *WCh) ; 

int getcchar (const cchar_t *WCVal, wchar_t *WCh, attr_t *attfS, 

short *COlor_pair, void *optS) ; 
int getch(void); 

int getnstr(char *Stf, int n) ; 

int getn_wstr (wint_t *WStr, int n) ; 

int getstr(char *str) ; 

int get_wch (wint_t *ch) ; 

WINDOW *getwin (FILE *filep) ; 

int get_wstr (wint_t *WStf) ; 

int halfdelay (int tenths); 
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bool has_colors(void) ; 

bool has_ic(void) ; 

bool has_il(void); 

int hline(chtype Ch, int n) ; 

int hline_set(const cchar_t *WCh, int n) ; 

void idcok (WINDOW *win, bool bf) ; 

int idlok (WINDOW *win, bool bf) ; 

void immedok (WINDOW *win, bool bf) ; 

chtype inch(void); 

int inchnstr (chtype *chstr, int n) ; 

int inchstr (chtype *chstr) ; 

WINDOW *initscr(void); 

int init_color (short color, short red, short green, short blue); 

int init_pair (short pair, short f, short b) ; 

int innstr (char *Str, int n) ; 

int innwstr (wchar_t *WStr, int n) ; 

int insch(chtype Ch) ; 

int insdelln(int n); 

int insertln(void); 

int insnstr (const char *Str, int n) ; 
int insstr (const char *Str) ; 

int instr(char *Str) ; 

int ins_nwstr (const wchar_t *WStr, int n) ; 

int ins_wch(const cchar_t *WCh) ; 

int ins_wstr (const wchar_t *WStr) ; 

int intrflush (WINDOW *win, bool bf) ; 

int in_wch (cchar_t *WC\/al) ; 

int in_wchstr (cchar_t *WChstr) ; 

int in_wchnstr (cchar_t *WChstr, int n) ; 

int inwstr (wchar_t *WStr) ; 

bool isendwin(void); 

bool is_linetouched (WINDOW *win, int line); 

bool is_wintouched (WINDOW *win); 

char *keyname(int C) ; 

char *key_name(wchar_t C) ; 

int keypad (WINDOW *win, bool bf) ; 

char killchar(void); 

int killwchar(wchar_t *ch) ; 

int leaveok (WINDOW *win, bool bf) ; 

char *longname(void); 

int meta (WINDOW *win, bool bf) ; 

int move (int y, int X) ; 

int mvaddch(int y, int X, const chtype Ch) ; 
int mvaddchnstr (int y, int X, const chtype *chstr, int n) ; 
int mvaddchstr (int y, int X, const chtype *chstr) ; 
int mvaddnstr (int y, int X, const char *StT, int n) ; 
int mvaddnwstr (int y, int X, const wchar_t *WStr, int n) ; 
int mvaddstr(int y, int X, const char *Str) ; 
int mvaddwstr (int y, int X, const wchar_t *WStX) ; 

int mvadd_wch(int y, int X, const cchar_t *WCh); 

int mvadd_wchnstr (int y, int X, const cchar_t *WChstr, int n) ; 
int mvadd_wchstr (int y, int X, const cchar_t *WChstr) ; 
int mvchgat (int y, int X, int n, attr_t attr, short color, 
const void *0ptS) ; 

int mvcur (int oldrow, int oldcol, int newrow, int newcol) ; 
int mvdelch(int y, int X) ; 

int mvderwin (WINDOW *win, int par_y, int par_X) ; 
int mvgetch(int y, int X) ; 
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int 

int 

int 

int 

int 

int 

int 

chtype 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

int 

chtype 

int 

int 

int 

int 


mvgetnstr (int y, int X, char *Stf, int n) ; 
mvgetn_wstr (int y, int X, wint_t *WStr, int n) ; 
mvgetstr(int y, int X, char *StT) ; 
mvget_wch(int y, int X, wint_t *ch); 
mvget_wstr (int y, int X, wint_t *WStf) ; 
mvhline(int y, int X, chtype Ch, int n) ; 
mvhline_set(int y, int X, const cchar_t *WCh, int n) ; 
mvinch(int y, int X) ; 

mvinchnstr (int y, int X, chtype *chstr, int n) ; 
mvinchstr (int y, int X, chtype *chstr) ; 
mvinnstr(int y, int X, char *Str, int n) ; 
mvinnwstr (int y, int X, wchar_t *WStf, int n) ; 
mvinsch(int y, int X, chtype Ch) ; 
mvinsnstr (int y, int X, const char *Str, int n) ; 
mvinsstr(int y, int X, const char *Stf) ; 
mvinstr(int y, int X, char *Str) ; 

mvins_nwstr (int y, int X, const wchar_t *WStf, int n) ; 
mvins_wch(int y, int X, const cchar_t *WCh); 
mvins_wstr (int y, int X, const wchar_t *WStf) ; 
mvinwstr(int y, int X, wchar_t *WStr) ; 
mvin_wch(int y, int X, cchar_t *WCVal); 
mvin_wchnstr (int y, int X, cchar_t *WChstf, int n) ; 
mvin_wchstr (int y, int X, cchar_t *WChstr) ; 
mvprintw(int y, int X, char *fmt, ...); 
mvscanw(int y, int X, char *fmt, . ..); 
mwline(int y, int X, chtype Ch, int n); 
mwline_set (int y, int X, const cchar_t *WCh, int n) ; 
mvwaddch(WINDOW *win, int y, int X, const chtype Ch) ; 
mvwaddchnstr (WINDOW *win, int y, int X, const chtype *chstf, 
int n) ; 

mvwaddchstr (WINDOW *win, int y, int X, const chtype *chstr) ; 
mvwaddnstr (WINDOW *win, int y, int X, const char *StT, int n) ; 
mvwaddnwstr (WINDOW *win, int y, int X, const wchar_t *WStf, 
int n) ; 

mvwaddstr (WINDOW *win, int y, int X, const char *StT) ; 
mvwaddwstr (WINDOW *win, int y, int X, const wchar_t *WStr) ; 
mvwadd_wch(WINDOW *win, int y, int X, const cchar_t *WCh) ; 
mvwadd_wchnstr (WINDOW *win, int y, int X, const cchar_t *WChstr, 
int n) ; 

mvwadd_wchstr (WINDOW *win, int y, int X, const cchar_t *WChstf) ; 
mvwchgat (WINDOW *win, int y, int X, int n, attr_t attr, 
short COlOr , const void *0ptS) ; 
mvwdelch (WINDOW *win, int y, int X); 
mvwgetch (WINDOW *win, int y, int X); 

mvwgetnstr (WINDOW *win, int y, int X, char *Stf, int n) ; 
mvwgetn_wstr (WINDOW *win, int y, int X, wint_t *WStr, int n) ; 
mvwgetstr (WINDOW *win, int y, int X, char *Str) ; 
mvwget_wch (WINDOW *win, int y, int X, wint_t *ch) ; 
mvwget_wstr (WINDOW *win, int y, int X, wint_t *WStr) ; 
mvwhline (WINDOW *win, int y, int X, chtype Ch, int n) ; 
mvwhline_set (WINDOW *win, int y, int X, const cchar_t *WCh, 
int n) ; 

mvwin (WINDOW *win, int y, int X); 
mvwinch (WINDOW *win, int y, int X); 

mvwinchnstr (WINDOW *win, int y, int X, chtype *chstr, int n) ; 
mvwinchstr (WINDOW *win, int y, int X, chtype *chstr) ; 
mvwinnstr (WINDOW *win, int y, int X, char *Str, int n) ; 
mvwinnwstr (WINDOW *win, int y, int X, wchar_t *WStf, int n) ; 
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int mvwinsch (WINDOW *win, int y, int X, chtype Ch) ; 

int mvwinsnstr (WINDOW *win, int y, int X, const char *Str, int n) ; 

int mvwinsstr (WINDOW *win, int y, int X, const char *StX) ; 

int mvwinstr (WINDOW *win, int y, int X, char *Str) ; 

int mvwins_nwstr (WINDOW *win, int y, int X. const wchar_t *WStr, 

■ int n) ; 

int mvwins_wch (WINDOW *win, int y, int X, const cchar_t *WCh) ; 
int mvwins_wstr (WINDOW *win, int y, int X, const wchar_t *WStr) ; 
int mvwinwstr (WINDOW *win, int y, int X, wchar_t *WStr) ; 

C int mvwin_wch (WINDOW *win, int y, int X, cchar_t *WCVal ) ; 

int mvwin_wchnstr (WINDOW *win, int y, int X, cchar_t *WChstr, 
int n) ; 

int mvwin_wchstr (WINDOW *win, int y, int X, cchar_t *WChstr) ; 

int mvwprintw (WINDOW *win, int y, int X, char *fmt, . ..); 
int mvwscanw (WINDOW *win, int y, int X, char *fmt, ...); 

int mvwvline (WINDOW *win, int y, int X, chtype Ch, int n) ; 

int mvwvline_set (WINDOW *win, int y, int X, const cchar_t *WCh, 

int n) ; 

int napms (int ms) ; 

WINDOW *newpad (int nlines, int ncds) ; 

SCREEN *newterm (char *type, FILE *OUtfile, FILE *infile) ; 

window *newwin(int nlines, int ncds, int begin_y, int begin_X); 

int nl(void); 

int nonl(void); 

int nocbreak(void); 

int nodelay (WINDOW *win, bool bf) ; 

int noecho(void); 

void noqiflush(void); 

int noraw(void); 

int notimeout (WINDOW *win / bool bf) ; 

int overlay (const WINDOW *srcwin, WINDOW *dstwin) ; 

int overwrite (const WINDOW *srcwin, WINDOW *dstwin) ; 

int pair_content (short pair, short *f, short *b) ; 

int PAIR_NUMBER (int value) ; 

int pechochar (WINDOW *pad, chtype *ch) ; 

int pecho_wchar(WINDOW *pad, const cchar_t *WCh) ; 

int pnoutrefresh (window *pad, int pminrow, int pmincd, int sminrow, 

int smi ncol , int smaxrow , int smaxcd) ; 
int prefresh (window *pad, int pminrow, int pmincd, int sminrow, 
int smi ncol , int smaxrow , int smaxcd) ; 
int printw(char *fmt, 

int putp (const char *Str) ; 

int putwin (WINDOW *win, FILE *filep) ; 

void qiflush(void); 

int raw(void); 

int redrawwin(WINDOW *win); 

int refresh(void); 

int resetty(void); 

int reset_prog_mode(void); 

int reset_shell_mode(void); 

int ripoffline (int line, int (*init) (WINDOW *win, int columns)); 
int savetty(void); 

int scanw(char *fmt, . . . ) ; 

int scr_dump (const char *filename) ; 

int scr_init (const char *filename) ; 

int scrl(int n) ; 

int scroll(WINDOW *win); 

int scrollok (WINDOW *win, bool bf) ; 

int scr_restore (const char *filename) ; 
int scr_set (const char ^filename) ; 

int setcchar(cchar_t *WCVal , const wchar_t *WCh, 

const attr_t attrs, short color_pair, 
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const void *0ptS) ; 
int setscrreg (int top, int bot) ; 

SCREEN *set_term(SCREEN *ne/V) ; 

int slk_attroff (const chtype attfS) ; 

int slk_attr_of f (const attr_t attfS, void *0ptS) ; 

int slk_attron (const chtype attfS); SHH 

int slk_attr_on (const attr_t attfS, void *0ptS) ; 
int slk_attrset (const chtype attfS) ; 

int slk_attr_set (const attr_t attfS, short COlOf_paif, 

void *0ptS) ; Q 

int slk_clear(void) ; 

int slk_init(int fmt) ; 

char *slk_label (int labfium) ; 
int slk_noutrefresh(void) ; 

int slk_refresh(void) ; 

int slk_restore(void); 

int slk_set (int labfium, const char *label, int justify); 

int slk_touch(void) ; 

int slk_wset (int labfium, const wchar_t *label, int justify); 
int standend(void); 

int standout(void); 

int start_color(void); 

window * subpad (window *orig, int nlines, int ncds, int begin_y, 
int begi n_x) ; 

window * subwin (window *orig, int nlines, int ncols, int begin_y, 
int begi n_x) ; 

int syncok (WINDOW *wifl, bool bf) ; 

chtype termattrs(void); 
attr_t term_attrs(void); 
char *termname(void); 
int tigetf lag (char *capname) ; 

int tigetnum (char *capname) ; 
char *tigetstr (char *capname) ; 
void timeout (int delay); 

int touchline (WINDOW *win, int Start, int count); 

int touchwin(WINDOW *win); 

char *tparm(char *cap, long pi, long p2, long p3, long p4, 
long p5, long p6, long p7, long p8, long p9) ; 
int typeahead(int fildes) ; 

int ungetch(int Ch) ; 

int unget_wch(const wchar_t WCh) ; 

int untouchwin(WINDOW *win); 

void use_env (bool boolvalue) ; 

int vidattr (chtype attf) ; 

int vid_attr (attr_t attf, short COlOf_paif, void *0ptS) ; 
int vidputs (chtype attf, int (*putfunc) (int)); 
int vid_puts (attr_t attf, short COlOf_paif, void *opt, 

int (*putwfunc) (int) ) ; 
int vline(chtype Ch, int n) ; 

int vline_set(const cchar_t *WCh, int n) ; 

int vwprintw (WINDOW *wifl, char *fmt, void *varglist) ; 
int vw__printw (WINDOW *win, char *fmt, void *varglist) ; 
int vwscanw (WINDOW *win, char *fmt, void *varglist) ; 
int vw_scanw (WINDOW *win, char *fmt, void *varglist) ; 
int waddch (WINDOW *wifl, const chtype Ch) ; 
int waddchnstr (WINDOW *win, const chtype *chstf, int n) ; 
int waddchstr (WINDOW *win, const chtype *chstf) ; 
int waddnstr (WINDOW *wifl, const char *Stf, int n) ; 
int waddnwstr (WINDOW *wifl, const wchar_t *WStf, int n) ; 
int waddstr (WINDOW *win, const char *Stf) ; 
int waddwstr (WINDOW *win, const wchar_t *WStf) ; 

int wadd_wch (WINDOW *wifl, const cchar_t *WCh) ; 
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int wadd_wchnstr (WINDOW *win, const cchar_t *WChstf, int n) ; 

int wadd_wchstr (WINDOW *win, const cchar_t *WChstr) ; 

int wattroff (WINDOW *win, int attrs) ; 

int wattron (WINDOW *win, int attrs); 

int wattrset (WINDOW *win, int attrs); 

int wattr_get (WINDOW *win, attr_t *attrs, short *COlor_pair, void *0ptS) ; 

int wattr_off (WINDOW *win, attr_t attrs, void *0ptS) ; 

int wattr_on (WINDOW *win, attr_t attrs, void *0ptS) ; 

int wattr_set (WINDOW *win, attr_t attrs, void *0ptS) ; 

int wbkgd(WINDOW *win, chtype Ch) ; 

void wbkgdset(WINDOW *win, chtype Ch) ; 

int wbkgrnd(WINDOW *win, const cchar_t *WCh) ; 

void wbkgrndset(WINDOW *win, const cchar_t *WCh) ; 

int wborder (WINDOW *win, chtype Is, chtype TS, chtype tS, chtype bs, 
chtype tl , chtype tr, chtype bl , chtype br) ; 
int wborder_set (WINDOW *win, const cchar_t *ls, const cchar_t *fS, 
const cchar_t *tS, const cchar_t *bs, 
const cchar_t *tl , const cchar_t *tf , 
const cchar_t *bl, const cchar_t *br) ; 
int wchgat (WINDOW *win, int n, attr_t attr, short color, 
const void *0ptS) ; 
int wclear(WINDOW *win); 

int wclrtobot(WINDOW *win); 

int wclrtoeol(WINDOW *win); 

void wcursyncup(WINDOW *win); 

int wdelch(WINDOW *win); 

int wdeleteln(WINDOW *win); 

int wechochar(WINDOW *win, const chtype Ch) ; 

int wecho_wchar(WINDOW *win, const cchar_t *WCh); 

int werase(WINDOW *win); 

int wgetbkgrnd(WINDOW *win, cchar_t *WCh) ; 

int wgetch(WINDOW *win); 

int wgetnstr (WINDOW *win, char *Str, int n) ; 

int wgetn_wstr (WINDOW *win, wint_t *WStf, int n) ; 

int wgetstr (WINDOW *win, char *Str) ; 

int wget_wch (WINDOW *win, wint_t *ch) ; 

int wget_wstr (WINDOW *win, wint_t *WStf) ; 

int whline (WINDOW *win, chtype Ch, int n) ; 

int whline_set(WINDOW *win, const cchar_t *WCh, int n) ; 

chtype winch (WINDOW *win); 

int winchnstr (WINDOW *win, chtype *ChstX, int n) ; 

int winchstr (WINDOW *win, chtype *chstr) ; 

int winnstr (WINDOW *win, char *Str, int n) ; 

int winnwstr (WINDOW *win, wchar_t *WStf, int n) ; 

int winsch (WINDOW *win, chtype Ch) ; 

int winsdelln (WINDOW *win, int n) ; 

int winsertln(WINDOW *win); 

int winsnstr (WINDOW *win, const char *Str, int n) ; 
int winsstr (WINDOW *win, const char *Str) ; 
int winstr (WINDOW *win, char *Str) ; 

int wins_nwstr (WINDOW *win, const wchar_t *WStr, int n) ; 
int wins_wch (WINDOW *win, const cchar_t *WCh) ; 
int wins_wstr (WINDOW *win, const wchar_t *WStr) ; 
int winwstr (WINDOW *win, wchar_t *WStf) ; 

int win_wch (WINDOW *win, cchar_t *WC\/al); 

int win_wchnstr (WINDOW *win, cchar_t *WChstr, int n) ; 
int win_wchstr (WINDOW *win, cchar_t *WChstr) ; 

int wmove (WINDOW *win / int y, int X); 
int wnoutrefresh (WINDOW *win); 

int wprintw (WINDOW *win, char *fmt, ...); 

int wredrawin (window *win, int beg line, int numjines) ; 

int wrefresh (WINDOW *win); 
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int wscanw (WINDOW *win, char *fmt, . . .); 

int wscrl (WINDOW *win, int n) ; 

int wsetscrreg (WINDOW *win, int top, int bot) ; 

int wstandend (WINDOW *win); 

int wstandout (WINDOW *win); 

void wsyncdown (WINDOW *win); 

void wsyncup (WINDOW *win); 

void wtimeout (WINDOW *win, int delay); 

int wtouchln (WINDOW *win, int y, int n, int changed); 

wchar_t *wunctrl (cchar_t *WC) ; 

int wvline (WINDOW *win, chtype ch, int n) ; 

int wvline_set (WINDOW *win, const cchar_t *WCh, int n) ; 

APPLICATION USAGE 

In order to support historical applications that include <curses.h> and use <varargs.h> thefollow- 
ing interfaces using vajist are declared as having a third argument of type (void *): vw_printw() , 
vw_scanw(),vwprintw(),vwscanw)). 

SEE ALSO 

<stdio.h>(in theX/Open System Interfaces and Headers, Issue 4, Version 2 specification), <term.h>, 
<termios.h> (in the X/Open System Interfaces and Headers, Issue 4, Version 2 specification), 
<unctrl.h>, <wchar.h> (in the X/Open System Interfaces and Headers, Issue 4, Version 2 

specification). 

curses_intro(3X). 

CHANGE HISTORY 

First released in X/Open Curses, Issue 2. 

X/Open Curses, Issue 4 

The entry iscompletely rewritten to include new constants, data types and function prototypes. 
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NAME 

dirent.h - format of directory streams and directory entries 

SYNOPSIS 

include <sys/types.h> 
include <dirent.h> 

DESCRIPTION 

This header file defines data types used by the directory stream routines described in directory(3C). 

The foil owing data types are defined: 

dir A structure containing information about an open directory stream. 

struct dirent A structure defining the format of entries returned by the readdir function (see 
directory(3C)). 

The struct dirent structure includes the foil owing members: 

char d name[MAXNAMLEN+1]; /* name of directory entry */ 

ino_t d ino; /* file serial number */ 

short d namlen; /* length of string in d name */ 

short d reclen; /* length of this record */ 

The constant maxnamlen is defined in <dirent.h>. 

Note that the d_reclen entry is used internally to represent the offset from the current entry to the next 
valid entry. Therefore, d_reclen is not the length of the current entry, but the length of the current record 
where a record is an entry plus any currently unused space between the current entry and the next valid 
entry. The unused space between valid dirent entries results from changes in a directory's contents, such 
as the deletion of files and other directories. 

This file also contains external declarations for the functions in the directory(3C) package. 

AUTHOR 

dirent.h was developed by AT&T and HP. 

SEE ALSO 

directory(3C), ndir(5). 

STANDARDS CONFORMANCE 

<dirent.h>: AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSI X.l 


Section 5-34 


1 


HP-UX Release 11.0: October 1997 


did .si (5) 


dld.sl(5) 


NAME 

did.si - dynamic loader 

MULTITHREAD USAGE 

The dynamic loader is thread-safe. 

DESCRIPTION 

The /usr/lib/pa20_64/dld. si program is the PA64 dynamic loader. The /usr/lib/dld. si 
program is the PA32 dynamic loader. I n programs that use shared libraries, did. si is invoked automati¬ 
cally at startup time by exec on PA64 and by the startup file crtO.o on PA32. Identical copies of 
crtO.o are kept in both /opt/langtools/lib and /usr/ccs/lib directories. The dynamic 
loader is, itself, a shared library, although it defines no symbols for use by user programs. 

Shared Libraries 

Shared libraries are executable files created with the -b option to Id (see I d(1)). They must contain 
position-independent code (PIC) that can be mapped anywhere in the address space of a process and exe¬ 
cuted with minimal relocation, pic can use PC-relative addressing modes and/or linkage tables. It is gen¬ 
erated by default by the compilers on PA64 and by specifying the +z/+Z options on PA32. Seethe+help 
option to Id(1) or the HP-UX Linker and Libraries User's Guide manual for details on writing pic in assem¬ 
bly language. 

Incomplete Executables 

An executable program linked with one or more shared libraries is called an incomplete executable. 

When creating an executable (a.out) file from object files and libraries, the linker does not copy text 
(code) or data from the shared library into the output file. I nstead, the dynamic loader maps the library 
into the address space of the process at run time. The linker binds all program references to shared library 
routines and data to entries in a linkage table, and relies on the dynamic loader to fill in the linkage table 
entries once the libraries have been mapped. This linkage table serves as a jump tablefor function calls. 

Thread local storage is now supported. The dynamic loader will tally each shared library's thread local 
storage size as well as the program's thread local storage size. When all libraries are loaded, on PA32 the 
dynamic loader will either call a thread routine to set the thread pointer and allocate space for the initial 
thread or will call mmap() and lwp_setprivate () to allocate the space and setup the thread 
pointer. On PA64, the dynamic loader will invoke an initializer in the system library libc which will do 
the thread initialization, allocation of the initial thread, and set the thread pointer. 

On previous PA32 releases, shared library data items referenced by the program were copied into the pro¬ 
gram executable file so that the data references could be resolved statically. Beginning with the Series 
700/800 10.0 release, references to shared library data from the a. out are included in a linkage table and 
are resolved at run time. 

Loading 

An incomplete executable contains a list of path names of the shared libraries searched at link time. At run 
time, the dynamic loader attaches to the process all shared libraries that were linked with the program. 
The dynamic loader will attempt to load each library from the same directory in which it was found at link 
time. It is possible to change the shared library run time search path by specifying a dynamic path list. 
See PA32 Dynamic Path List and/or PA64 Dynamic Path List. 

The text segment of a library is shared among all processes that use it. The data and bss segments are 
shared on a page-by-page basis. When a process first accesses (reads or writes) a data or bss page, a copy of 
that page is made for the process. 

PA32 Dynamic Path List 

There are two was to specify a dynamic path list: 

• by storing a directory path list in the executable using the -fb path list option to Id, 

• by linking the executable with Id option +s, enabling the executable to use the path list defined by 
the SHLIB_PATH environment variableat run time. 

The path list is a list of one or more path names separated by colons (:). The dynamic path list will work 
only for libraries specified with the -1 or -1 : options to Id. However, it can be enabled for libraries 
specified with a full path name using the -1 option to chatr (see chatr(l)). If both +s and -fb are 
used, their relative order on the command line indicates which path list will be searched first in compatibil¬ 
ity mode. See the +help option to I d (1) or the HP-UX Linker and Libraries User's Guide manual for more 
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details. 

PA64 Dynamic Path List 

For standard mode libraries (libraries built or linked with Id +std ), the dynamic loader will use 
dynamic path searching to find shared libraries whose names appear in a library list of the program or 
loaded shared libraries with no embedded / character. Dynamic path searching is enabled by default for 
these standard mode libraries or executables. If Id fnoenwar is specified, thedynamic loader will not 
look at any dyanmic path environment variables to find dependent shared libraries. This limits the 
dynamic path searching to the value of rpath and the default directories /usr/lib/pa20_64 and 
/usr/ccs/lib/pa20_64. 

For compatibility mode libraries (libraries built or linked with Id -Fcompat ), the dynamic loader will only 
do dynamic path searching for these libraries if they were linked with -lor -1: and one of these were 
specified: 

• Id +s 

• Id +b 

• chatr +s enable 

There are several ways to specify a dynamic path list: 

• By storing a directory path list in the executable using the +b path list option to Id. 

• By not specifying Id +b and letting the linker set the rpath value to a concatenation of the Id 
-L pathjist followed by the value of the environment variable LPATH followed by the default direc¬ 
tories /usr/lib/pa20_64 and /usr/ccs/lib/pa20_64. This is for standard mode shared 
libraries only. 

• By storing a directory pathjist in the environment variables LD_LIBRARY_PATH and/or 
SHLIB_PATH . For compatibility mode shared libraries and executables, the directory path_list 
should only be put in the SHLIB_PATH environment variable. 

The path list is a list of one or more path names separated by colons (:). The dynamic path list will work 
only for libraries specified with the -1 or -1 : options to Id. Flowever, it can be enabled for libraries 
specified with a full path name using the -1 option to chatr (see chatr(l)). If both +s and +b are 
used, their relative order on the command line indicates which path list will be searched first in compatibil¬ 
ity mode. See the +help option to I d (1) or the FIP-UX Linker and Libraries User's Guide manual for more 
details. 

The dynamic loader will use these rules when determining which dynamic path list to use: 

• If Id -Fnoenwar was specified and Id +b and Id -Fcompat were not specified, then the only 
dynamic path searching that can be done is to look at the path_l ist in rpath followed by the default 
directories /usr/lib/pa20_64 and /usr/ccs/lib/pa20_64. 

• If Id -Fcompat was specified and Id +b and Id +s were not specified, no shared library is sub¬ 
ject to dynamic path searching. 

• If the Id -Fcompat and Id +b options are not specified, then the pathjist in the 
LD_LIBRARY_PATH environment variable is searched, followed by the pathjist in the 
SHLIB_PATH environment variable, followed by the pathjist in rpath, followed by the default 
directories /usr/lib/pa20_64 and /usr/ccs/lib/pa20_64. 

• If the Id -Fcompat, Id +b, and Id +s are specified, then use the relative ordering of Id +b 
and Id +s to determine if the dynamic loader should use the pathjist in rpath before 
SHLIB_PATH followed by library as specified in the library list. If Id +b is specified first, use the 
pathjist in rpath first. 

The rules change slightly when looking for dependent shared libraries. 

• For standard mode libraries, the pathjist in the LD_LIBRARY_PATH environment variable is 
searched first, followed by the pathjist in the SHLIB_PATH environment variable, followed by the 
value in the parent shared library's rpath, followed by the default directories 
/usr/lib/pa20_64 and /usr/ccs/lib/pa20_64. The ancestors of a parent shared library 
may contain a pathjist in rpath, but this is ignored when searching for dependent shared libraries 
of this parent. Only the parent's rpath is used. 

• For compatibility mode libraries, the search is the same as for parent shared libraries, except rpath 
can be passed from parent shared libraries to child dependent shared libraries to that child's 
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dependents, et cetera. 

Binding 

The dynamic loader also resolves symbolic references between the executable and libraries. By default, 
function calls are trapped via the linkage table and bound on first reference. References to data symbols 
and other absolute address references cannot be trapped. They are bound on the first resolution of a func¬ 
tion call that could potentially reference the object. 

If the -B immediate option to Id is used, the loader binds all necessary references at startup time. 
This increases the startup cost of a program, but ensures that no more binding operations will be required 
later. Thus, better real-time response may result, and the risk of a later abort due to unresolved externals 
is eliminated. 

The fastbind tool can be used to improve the start-up time of programs that use shared libraries 
(incomplete executables). The fastbind tool performs analysis on the shared library routines and data 
used to bind the symbols and stores this information in the executable file. The dynamic loader will notice 
that this information is available, and it will use this fastbind information to bind the symbols instead of the 
standard search method. For more details refer to fastbind(l) and the -Fhelp option to Id (1) or the HP-UX 
Linker and Libraries User's Guide manual. 

Breadth-first Searching 

This is only availableon PA64. By default, the dynamic loader will do breadth-first searching when binding 
symbols. If the incomplete executable was linked with -Fcompatorifa shl_load() is being executed, 
then depth-first searching is used. Breadth-first searching specifies that the dynamic loader will look for 
symbols starting with the incomplete executable followed by all loaded shared libraries in a left to right 
order until the symbol is found. For example, the incomplete executable is searched followed by all 
libraries in its library load list. Then the dependent shared libraries of the first library in the library load 
list list is searched, followed by the dependent shared libraries of the second library in the list, et cetera. 

Depth-first Searching 

This is the only search behavior on PA32 and is used on PA64 if doing a shl_load () or if the incomplete 
executable was linked with -Fcompat . The dynamic loader will search the incomplete executable foil owed 
by the first library in its library load list. The first dependent library of this library is then searched, fol¬ 
lowed by the first dependent of this dependent, and so on. When there are no more dependents, the 
siblings and their dependents are searched until eventually the second library in the program's library load 
list is searched, followed by thefirst dependent of this library, et cetera. 

Version Control 

Since code from a shared library is mapped at run time from a separate shared library file, modifications to 
a shared library may alter the behavior of existing executables. In some cases, this may cause programs to 
operate incorrectly. Two means of version control is provided to solve this problem. 

Intra-Library Versioning 

This is availableon PA32 only. Whenever an incompatible change is made to a library interface, both ver¬ 
sions of the affected module or modules are included in the library. A mark indicating the date 
(month/year) the change was made is recorded in the new module via the pragma HP_SHLIB_VERSI0N 
in C, or the compiler directive SHLIBJVERSION in Fortran and Pascal. This date applies to all symbols 
defined within the module. A high water mark giving the date of the latest incompatible change is recorded 
in the shared library, and the high water mark for each library linked with the program is recorded in the 
incomplete executable file. At run time, the dynamic loader checks the high water mark of each library and 
loads the library only if it is at least as new as the high water mark recorded at link time. When binding 
symbolic references, the loader chooses the latest version of a symbol that is not later than the high water 
mark recorded at link time. These two checks help ensure that the version of each library interface used at 
run time is the same as was expected at link time. I ntra-library versioning may be removed in a future 
release. 

Library-level Versioning 

The second way for users to version their libraries is by using a new naming convention, libname.n where 
n is a numeral that is incremented with every new release of the library. When using the new naming 
scheme, users must specify an internal name for the shared library by using the +h internal_name 
option to Id when building the shared library. This internal name is recorded in each incomplete execut- 
ableor shared library that links with the shared library. 
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At run time, the loader will look at the library list recorded in the incomplete executable file or shared 
library. For each library in the list that was not an internal name, the dynamic loader will look for a .0 
version of the library (eg. libname. 0 ) to load. If it does not find this version, it will look for the library 
name that is recorded in the list. 

PA32 Explicit Loading and Binding 

The duties of the dynamic loader as described above are all performed automatically, although they can be 
controlled somewhat by appropriate options to Id. The dynamic loader can also be accessed programmati¬ 
cally. The reserved symbol_ dld_loc , which is defined in crtO .o, points to a jump table within 

the dynamic loader. The routines described under shl_load(3X) providea portable interface that allows the 
programmer to explicitly attach a shared library to the process at run time, to calculate the addresses of 
symbols defined within shared libraries, and to detach the library when done. 

PA64 Explicit Loading and Binding 

The duties of the dynamic loader as described above are all performed automatically, although they can be 
controlled somewhat by appropriate options to Id. The dynamic loader can also be accessed programmati¬ 
cally. The routines described under shl_load(3X), dlclose(3C), dlerror(3C), dlget(3C), dlmodinfo(3C), 
dlopen(3C), and dlsym(3C) provide a portable interface that allows the programmer to explicitly attach a 
shared library to the process at run time, to calculate the addresses of symbols defined within shared 
libraries, and to detach the library when done. 

DIAGNOSTICS 

If the dynamic loader is not present, or cannot be invoked by the process for any reason, an error message 
is printed to standard error and the process terminates with a non-zero exit code. 

These errors fall into two basic categories: errors in attaching a shared library, and errors in binding sym¬ 
bols. The former can occur only at process startup time but the latter can occur at any time during process 
execution unless the -B immediate option is used with Id. Possible errors that can occur while attach¬ 
ing a shared library include library not present, library not executable, library corrupt, high watermark too 
low, or insufficient room in the address space for the library. Possible errors that can occur while binding 
symbols include symbol not found (unresolved external), or library corrupt. 

When using the explicit load facilities of the dynamic loader, these types of errors are not considered fatal. 
Consult shl_load(3X), dlclose(3C), dlget(3C), dlgetname(3C), dlmodinfo(3C), dlopen(3C), and dlsym(3C) for 
more information. On PA64, to see error messages, use the dlerror () routine. This routine will print 
the last error message recorded by the dynamic loader. 

WARNINGS 

The startup cost of the dynamic loader is significant, even with deferred binding, and can cause severe per¬ 
formance degradation in processes dominated by startup costs (such as simple "hello world" programs). In 
addition, position-independent code is usually slower than normal code, so performance of a program may 
be adversely affected by the presence of pic in shared libraries. However, the advantages of decreased disk 
space usage and decreased memory requirements for executables should outweigh these concerns in most 
cases. 

There are rare cases where the behavior of a program differs when using shared libraries as opposed to 
archive libraries. This happens primarily when relying on undocumented and unsupported features of the 
compilers, assembler, and linker. See the +help option to I d (1) or the HP-UX Linker and Libraries User's 
Guide manual for more details. 

The library developer is entirely responsible for version control and must be thorough in identifying incom¬ 
patible changes to library interfaces. Otherwise, programs may malfunction unexpectedly with later ver¬ 
sions of the library. There is little an application user can do if version control is not handled properly by 
the library developer. The application developer can usually resolve problems by modifying the source code 
to use the new interfaces then recompiling and relinking against the new libraries. 

By default, most warnings are not reported by the dynamic loader. 

On PA32, if you wish to see all of the messages, set the environment variable _HP_DLDOPTS to contain 
oneor moreoptions. Thefollowingoptionsaresupported: 

-warnings Display additional dynamic loader warning messages. Some of these include: 

• Symbolsof the same name but different types, such as CODE and DATA. Seethe 
WARNINGS section in Id(1) for more details on this warning. 
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• Using certain flags or routines described in shl_load(3X). 

-fbverbose See fastbind(l). 

-nofastbind See fastbind(l). 

On PA64, if you wish to see all error messages, set the environment variableDLD_VERBOSE_ERR to true. 

AUTHOR 

The /usr/lib/dld. si and /usr/lib/pa20_64/dld. si shared libraries were developed by HP. 

SEE ALSO 

System Tools: 

as(l) 

CC(1) 
cc(l) 
chatr(l) 
f77(l) 
fastbind(l) 

I d (1) 
pc(l) 

Miscellaneous: 

a.out(4) assembler, compiler, and linker output 

dlclose(3C) unload a shared library previously loaded by dlopen() 

dlerror(3C) print the last error message recorded by did 

dlget(3C) return information about a loaded module 

dlgetname(3C) return the name of the storage containing a load module 

dlmodinfo(3C) return information about a loaded module 

dlopen(3C) load a shared library 

dlsym(3C) get the address of a symbol in a shared library 

shl_load(3X) load/unload shared libraries 

Texts and Tutorials 

HP-UX Linker and Libraries OnlineUser Guide 

(Seethe+help option to Id(1)) 

HP-UX Linker and Libraries User's Guide 

(See manuals(5) for ordering information) 


translate assembly code to machine code 
invoketheHP-UX C-H-compiler 
invoke the HP-UX C compiler 
change program's internal attributes 
invoketheHP-UX FORTRAN compiler 
i nvoke the fastbi nd tool 
invoke the link editor 
invoketheHP-UX Pascal compiler 
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NAME 

environ - user environment 

DESCRIPTION 

An array of strings called the environment is made available by e<ec(2) when a process begins. By con¬ 
vention, these strings have the form name=value. The following names are used by various commands 
(listed in alphabetical order): 

home Name of the user's login directory, set by login(l) from the password file (see passwd(4)). 

lang Identifies the user's requirements for native language, local customs and coded character set, if 

the environment variables lc all, lc collate, lcctype, lc messages, lc monetary, 
lc_numEriC, and lc_tiME are unset or null. 

The format of LANG is: 

LAN G=language[_territory][. codeset] 

The valid values for LANG are supported locales. (See lang(5).) Native Language Support 
(NLS) is initiated at run-time by calling setlocale(3C). The following call to setlocale binds the 
execution of a program to the user's language requirements: 

setlocale(LC_ALL,""); 

This setlocale call initializes the program locale from the environment variables associated 
with setlocale. lang provides the necessary defaults if any of the category-specific environ¬ 
ment variables are not set or set to the empty string. 

The lang environment variable can have a maximum length of SL_NAME_SIZE bytes (see 
header file <locale.h>). 

langopts Defines languageoptions for mode and data order intheform: 

LANGOPTS=[mode][_order] 

langopts values are given in English as an ascii character string, mode describes the mode 
of a file where I (ell) represents Latin mode and n represents non-Latin mode. Non-Latin 
mode is assumed for values other than I and n. order describes the data order of a file where 
k is keyboard order and s is screen order. 

lc all Determines the values for all locale categories. The value of lc all has precedence over any 
of the other environment variables lc collate, lc ctype, lc messages, lc_monetary, 
LC_NUM ERIC, LC_TI ME, and LANG . 

LC_COLLATE, lc_ctype, lc_messages, LC_MONETARY, LC_NUMERIC, and LC_TI M E 

determines the user's requirements for language, territory, and codeset with respect to charac¬ 
ter collation, character classification and conversion, output messages, currency symbol and 
monetary value format, numeric data presentation, and time formats, respectively. If 
LC_ALL and any of these are not defined in the environment, lang provides the defaults. 

Syntax for the environment variables lc collate, lc ctype, lc messages, lc monetary, 
LC_NU M E RI C, and LC_TI M E is: 

I a n g u a ge[ _ter r i tory ] [. cod eset ] [ @mod i fi er ] 

The language field conforms with ISO 639 standard for language names and the territory field 
conforms with the I SO 3166 territory names. For a list of the locale names, see lang(5). 

The (gmodifier field allows the user to select between more than one value of a category within 
the same language definition. HP-UX does not currently provide locales with modifiers. 

The values of the locale categories are determined by a precedence order; the first condition 
met below determines the value: 

1. If the LC_ALL environment variableis defined and is not null, the valueof LC_ALL is used. 

2. If the LC_* environment variable (LC COLLATE, LC CTYPE, LC MESSAGES, 
LC_MONETARY, LC_NUMERIC, LC_TIME) is defined and is not null, the value of the 
environment variable is used to initialize the category that corresponds to the environment 
variable. 

3. If the LANG environment variable is defined and is not null, the value of the LANG 
environment variableis used. 
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4. If the LANG environment variable is not set or is set to the empty string, the POSIX/C 
default locale is used. (See lang(5).) 

LCCOLLATE 

Determines the locale category for character collation. It determines collation information for 
regular expressions and sorting, including equivalence classes and multi-character collating 
elements, in various utilities and strcoll (3C) and strxfrm(3C). 

lc ctype Determines the locale category for character classification (such as alphabetic, digit, upper¬ 
case. See isalpha(3C), isdigit(3C), and isupper(3C)), character conversion, (see toupper(3C), 
tolower(3C)), and the interpretation of text as single-byteor multi-byte characters, 

LC_MESSAGES 

Determines the locale category for processing affirmative and negative responses and the 
language and cultural conventions in which diagnostic and informative messages should be 
written. It may also affect the behavior of catopen(3C) in determining the message catalog to 
open. 

LC_MONETARY 

Determines the locale category for monetary-related numeric formatting information. 
LC_NUMERIC 

Determines the locale category for numeric formatting information (such as the thousands 
separator and the radix character) in various utilities as well as the formatted I/O operations 
in printf(3S) and scanf(3S) and the string conversion functionsin strtod(3C). 

lc time Determines the locale category for date and time formatting information. It affects the 
behavior of time functions in strftime(3C). 

manpath Contains a colon-separated list of directory prefixes to be searched by man(l) for manual 
entries. Upon logging in, /etc/profile (or /etc/csh. login) sets 
MANPATH=/usr/share/man:/usr/contrib/man:usr/local/man. 

manpath uses the same syntax as the path environment variable, with the addition of recog¬ 
nizing the specifiers %L, %1, %t, and %c as used in the nlspath environment variable. See 
nlspath below for a description of these specifiers. This provides a way to specify paths to 
locale-specific manual entries. 

It is assumed that each of the prefixes given in manpath contain subdirectories of the form 
man*, man* . Z, cat* and cat* . Z. (See man(l), catman(lM ), and fixman(lM ).) 

nlspath Containsa sequence of pseudo-pathnames used by catopen(3C) when attempting to locate mes¬ 
sage catalogs. Each pseudo-pathname contains a name tempi ate consisting of an optional path 
prefix, one or more substitution field descriptors, a file name and an optional file name suffix. 
For example: 

N L S PATH -'/system/n I si i b/%N .cat" 

defines that catopen(3C) should look for all message catalogs in the directory 
/system/nlslib , where the catalog name should be constructed from the name parame¬ 
ter passed to catopen (3C) (%N) with the suffix . cat. 

Field descriptors consist of a % followed by a single character. Field descriptors and their sub¬ 
stitution values are: 

%N The value of the name parameter passed to catopen (3C). 

%L The value of lc_m essages. 

%1 The language element from lcmessages. 

%t The territory element from lc messages. 

%c The codeset element from lc messages. 

%% Replaced by a single %. 

For example, given: 

nlspath="/ system/nlslib/%L/%N.cat" 

catopen(3C) attempts to open the file /systern/nlslib/$LC_MESSAGES/name. cat as a 
message catalog. 

A null string is substituted if the specified value is not defined. Separators are not included in 
%t and %c substitutions. Note that a default valueis not supplied for %L. If lc messages is 
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PAGER 


PATH 


TERM 


TZ 


not set and nlspath had the value in the previous example, catopen(3C) would attempt to 
openthefile /system/nlslib/name. cat as a message catalog. 

Path names defined in nlspath are separated by colons (:). A leading colon or two adjacent 
colons)::) is equivalent to specifying %N. For example, given: 

NLSPATH=":%N.cat:/nlslib/%L/%N.cat" 

catopen(3C) with the oflag parameter set to NL_CAT_LOCALE will attempt to open the fol¬ 
lowing files in the indicated order: ./name, ,/name.cat, and /nlslib/$LC_MESSAGES/name.cat. 
The first file successfully opened is taken as the message catalog. 

A default pseudo-pathname defined by the system is effectively appended to nlspath and 
used by catopen(3C) whenever a message catalog cannot be opened in any of the user defined 
pseudo-pathnames. This system-wide default path is: 

/usr/lib/nls/msg/%L/%N.cat:/usr/lib/nls/%l/%t/%c/%N.cat 

pager indicates the paginator through which output from certain commands is piped. Its 
value must be a string specifying the complete command line of the desired paginator. Two 
examples are: 

PAGER="more -cs" 

PAGER="pg -c" 

pager affects several commands, including man(l) and the interactive mailers. Some of the 
affected commands provide alternate means of selecting a pager in case there is a conflict. See 
the individual manual entries for details. 

path indicates the sequence of directory prefixes that sh (1), time(l), nice(l), nohup(l), and 
others search when looking for a file known by an incomplete path name. Prefixes are 
separated by colons (:). Login(1) sets PATH =:/usr/bin. 

term identifies the kind of terminal for which output is to be prepared. This information is 
used by commands such as vi (1) and mm(l), which can exploit special capabilities of that ter¬ 
minal. 

tz sets time zone information, tz can beset using the format: 

[:]STDoffset[DST[offset][,rule]] 

where: 

std and dst Three or more bytes that designate the standard time zone (std) and summer 
(or daylight-savings) time zone (dst) std is required. If dst is not specified, 
summer time does not apply in this locale. Any characters other than digits, 
comma (,), minus (-), plus (+), or ascii nul are allowed. 

offset offset is the value that must be added to local time to arrive at Coordinated 
Universal Time(UTC). Offset isof theform : 

hh[:mm[:ss]] 

Flour (hh) is any value from 0 through 23. The optional minutes (mm) and 
seconds (ss) fields area valuefrom 0 through 59. The hour field is required. If 
offset is preceded by a -, the time zone is east of the Prime Meridian. A + 
preceding offset indicates that the time zone is west of the Prime Meridian. 
The default case is west of the Prime Meridian. 

rule rule indicates when to change to and from summer (daylight-savings) time. 

Therulehastheform : 

date'ti me, date'ti me 

where the first date/time specifies when to change from standard to summer 
time, and the second date/time specifies when to change back. Thetimefield 
is expressed in current local time. 

Theform of date should be oneof thefollowing : 

Jn J ulian day n (1 through 365). Leap days are not counted. Febru¬ 
ary 29 cannot be referenced. 
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n The zero-based J ulian day (0 through 365). Leap days are counted. 
February 29 can be referenced. 

Mm.n.d 

The d day (0 through 6) of week n (1 through 5) of month m (1 
through 12) of the year. Week 5 refers to the last day d of month 
m. Week 1 is the week in which the first day of the month falls. 
Day 0 is Sunday. 

time Time has the same format as offset except that no leading sign 
or "+") is allowed. The default, if time is not given, is 02:00:00. 

While the STD field and the offset field for STD must be specified, if the dst 
field is also provided, the system will supply default values for other fields not 
specified. These default values come from file /usr/lib/tztab (see 
tztab(4)), and, in general, reflect the various historical dates for start and end 
of summer time. 

Additional names may be placed in the environment by the e<port command and "name^alud 1 arguments 
in sh(l), or by exec( 2). It is unwise to add names that conflict with thefollowing shell variables frequently 
exported by .profile files: mail, psi, PS2 and ifs. 

The environment of a process is accessiblefrom C by using the global variable: 
char **environ; 

which points to an array of pointers to the strings that comprise the environment. The array is terminated 
by a null pointer. 

WARNINGS 

Some hp-ux commands and library routines do not usetheLANG, lc collate, lcctype, lc monetary, 
lc numeric, lc time, or langopts environment variables. Some commands do not use message cata¬ 
logs, so nlspath does not affect their behavior. See the external influences section of specific com¬ 
mands and library routines for implementation details. 

NOTES 

Coordinated Universal Time(UTC) is equivalent to Greenwich Mean Time(GMT). 

AUTHOR 

Environ was developed by AT&T and HP. 

SEE ALSO 

env(l), login(l), sh(l), exec(2), catopen(3C), ctime(3C), getenv(3C), setlocale(3C), profile(4), lang(5), term(5), 
tztab(4). 

STANDARDS CONFORMANCE 

environ: AES, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1 
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NAME 

fcntl - file control options 

SYNOPSIS 

#include <sys/types.h> 
#include <fcntl.h> 


DESCRIPTION 

The fcntl () function provides for control over open files. The <fcntl.h> include file describes 
requests and arguments to fcntl () andopen(). See fcntl (2) and open (2). 

The access modes set by open () and accessed by fcntl () are: 

0__RD0NLY 
OWRONLY 
O. RDWR 

The mask for file access modes is: 


OACCMODE 


The file status flags set by open () or fcntl () and accessed by fcntl () are: 


0_NDELAY 
O NONBLOCK 
O APPEND 
ODSYNC 
OSYNC 

ORSYNC|ODSYNC 
ORSYNC|OSYNC 
O^LARGEFILE 


Nonblocking I/O. 

POSIX-style nonblocking I/O. 

Append (writes guaranteed at the end). 

Write through cache for data. 

Write through cache for data and attributes. 

Write through cache for data on reads and writes. 

Write through cache for data and attributes on reads and writes. 

When the filesystem is mounted as large files enabled, the 0_LARGEFILE 
option allowsthefileto grow over 2 GB. 


The flag 0_SYNCI0 is a synonym for 0_SYNC and is defined for backward compatibility in <fcntl .h>. 


The flag values accessible only to open () are: 


0_CREAT 
O TRUNC 
OEXCL 
ONOCTTY 


Open with file create (uses third open arg). 
Open with truncation. 

Exclusive open. 

Do not assign a control ling terminal. 


The requests for fcntl () are: 


F_DUPFD 

F„GETFD 

F_SETFD 

F_GETFL 

F_SETFL 

F_GETLK 

F_SETLK 

F_SETLKW 


Duplicate file descriptor. 

Get file descriptor flags. 

Set file descriptor flags. 

Get file flags. 

Set file flags. 

Get blocking file lock. 

Set or clear file locks and fail on busy. 
Set or clear file locks and wait on busy. 


The file descriptor flag for F_GETFD, F_SETFD is: 


FD_CLOEXEC 


The file segment locking control structure struct flock, includesthefollowing members: 


short l_type; 
short l_whence; 
off_t l_start; 
off_t l_len; 
pid_t l_pid; 


/* F_RDLCK, F__WRLCK or F_UNLCK */ 

/* Flag - see lseek(2) */ 

/* Relative offset in bytes */ 

/* Size; if 0 then until EOF */ 

/* By F_GETLK - process holding lock */ 


The file segment locking types are: 

F_RDLCK Read lock. 

F_WRLCK Write lock. 

F_UNLCK Remove locks. 
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SEE ALSO 

fcntl(2), open(2). 

STANDARDS CONFORMANCE 

<fcntl.h>: AES, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1 
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NAME 

fenv - floating-point environment macros and functions 

SYNOPSIS 

#include <fenv.h> 

DESCRIPTION 

The header <fenv.h> declares two types and several macros and functions to provide access to the 
floating-point environment. The floating-point environment refers collectively to the floating-point status 
flags and control modes. A floating-point status flag is a system variable whose value is set as a side effect 
of the arithmetic to provide auxiliary information. A floating-point control mode is a system variablewhose 
value may be set by the user to affect the subsequent behavior of the arithmetic; on HP 9000 systems the 
control modes include the rounding direction mode, the underflow mode, and thetrap enables. 

The following types are defined: 

fenv_t Represents the entire floating-point environment. 

fexcept_t Represents the floating-point exception flags collectively. 

The following macros represent the floating-point status flags. They are defined as integral constant 
expressions. 

FE_INEXACT The inexact exception. 

FE_DIVBYZER0 The division-by-zero exception. 

FE_UNDERFLOW The underflow exception. 

FE_OVERFLOW The overflow exception. 

FE_INVALID The invalid operation exception. 

FE_ALL_EXCEPT The bitwise OR of all exception macros. 

The following macros represent the rounding direction modes. They are defined as integral constant 
expressions. 

FE_TONEAREST The round-to-nearest rounding direction mode. 

FE_UPWARD The round-toward-positive-infinity rounding direction mode. 

FE_DOWNWARD The round-toward-negative-infinity rounding direction mode. 

FE_TOWARDZERO The round-toward-zero rounding direction mode. 

The foil owing macro is defined as a pointer to const-qualified fenv_t: 

FE_DFL_ENV The default floating-point environment. 

The <fenv.h >header file and its contents have been approved for inclusion in the C9X standard. The HP 
implementation adds four HP-specific functions to the approved contents: fegetflushtozero (), 
fesetflushtozero(),fegettrapenable () ,and fesettrapenable() . 

FILES 

/usr/include/fenv.h 

SEE ALSO 

feclearexcept(3M), fegetexceptflag(3M), feraiseexcept(3M), fesetexceptflag(3M), fetestexcept(3M), 
fegetround(3M), fesetround(3M), fegetenv(3M), feholdexcept(3M), fesetenv(3M), feupdateenv(3M), 
fegetflushtozero(3M), fesetflushtozero(3M), fegettrapenable(3M), fesettrapenable(3M). 
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NAME 

fs_wrapper - configuration and binary files used by filesystem administration commands 

SYNOPSIS 

ff [—F FStype] ... 

fsck [— F FStype] ... 
fsdb [—F FStype] ... 
labelit [-F FStype] ... 
mkfs [—F FStype] ... 
mount [-F FStype] ... 
ncheck [-F FStype] ... 
newfs [-F FStype] ... 
quot [—F FStype] ... 
quotacheck [-F FStype] ... 
volcopy [-F FStype] ... 

DESCRIPTION 

The commands listed in the SYNOPSIS can operate on different types of file systems. Each command 
(except for mount) reads file system specific configuration files that control the command's behavior, and 
invokes a file system specific binary file to do the actual work. FStype is the file system type as optionally 
specified on the command line. If FStype is not given, then the file system type is determined from 
/etc/fstab by matching an entry in this file with a device special provided with the command (see 
individual commands for details of usage). 

Administrators may also define a default file system type for the above commands via the file 
/etc/default/f s. If this file exists, and contains the line: 

LOCAL= FStype 

(e.g., LOCAL=hfs), then the above commands will assume the FStype given in /etc/default/fs, 
unless an FStype is provided on the command line or is in /etc/fstab. The default file system 
specification is provided to maintain compatibility with pre-10.0 invocations of the commands. 

See the FILES section for a list of the files used. 

WARNINGS 

The configuration files /sbin/lib/mfsconfig.d/FStypeare supplied by FHP or by other file system 
vendors. They are not meant to be edited by System Administrators. Corruption or removal of these files 
may lead to strange behavior, including the inability to boot. 

The format of the configuration file is subject to change. 

The file system specific binary files are not normally executed directly. Flowever, if the configuration files 
become unusable, direct execution of these binary files may be a useful step in repairing and running the 
system again. The binary files accept the same arguments as the commands by which they are executed. 

The mount command is a special case. This command currently does not read a configuration file, and 
does not execute a file system specific binary file if FStype is cdfs, hfs, nfs, or lofs. The binary that 
handles these FStypes also processes other FStypes and calls the file system specific command if appropri¬ 
ate. 

For historical reasons, the hfs binary files also handle nfs and cdfs, so there are no separate binary 
files for the latter two file systems. 

The commands (except mount ) wi 11 not work if they are renamed, because they are symbolically linked to 
a single executable (/sbin/f s_wrapper). 
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FILES 

FStype is the file system type as optionally specified on the command line, command is the name of the 

command. 

/sbin/fs/ FStype/command File system specific binary files for the fsck, fsdb, mkfs, 

mount, and newfs commands. There may be additional file 
system specific binary files in this directory that are not associ¬ 
ated with f s_wrapper. 

/usr/lbin/f s/FStype/command File system specific binary files for the remaining commands. 

There may also be other file system specific binary files in this 
directory that are not associated with fs_wrapper . 

/sbin/lib/mf sconfig . d/FStype Configuration files for each file system type. 

/etc/default/f s File in which the default file system type can be defined. If this 

file does not exist, there is no default filesystem type. 

/etc/fstab Static information about the file systems 

SEE ALSO 

ff(lM), fsck(lM), fsdb(lM), mkfs(lM), mount(lM), ncheck(lM), newfs(lM), quot(lM), quotacheck(lM), 

volcopy(lM), fstab(4). 
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NAME 

hier - file system hierarchy 

DESCRIPTION 

The HP-UX file system is a hierarchical tree organized for administrative convenience. Within the file¬ 
system tree structure, distinct areas are provided for files that are private to one machine, files that can be 
shared by machines, and home directories. 

There are two types of files that are shared: those that can be shared by multiple machines of a common 
architecture, and those that can be shared by all machines. This organization allows sharable files to be 
stored on one machine (the server), but accessed by many machines (clients). 

The foil owing diagram illustrates the file system layout. Note that there are many directories that are not 
is this diagram, but are discussed below. 

Diagram of Directory Layout 
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The foil owing listing discusses a representative HP-UX directory hierarchy. Some HP-UX applications may 
add additional directories, which are not shown. 


/ 

/dev 

/etc 

/etc/opt 

/etc/rc.config.d 

/export 

/home 

/lost+found 

/mnt 

/net 

/opt 

/sbin 

/sbin/init.d 
/sbin/rcO.d 
/sbin/rcl.d 


Root directory. 

Special files (block and character device files); see mknod(lM). 

Host-specific configuration and administration databases. 

Directory for application-specific configuration files. (Configuration information 
for optional packages.) 

Startup configuration files. 

Default root of exported file systems. Server only. 

Default root for user directories. 

Storage directory for connecting detached files; for use by fsck(lM). 

Mounting point for local filesystems. 

M ounti ng poi nt for remote file systems. 

Root of subtree for optional application packages. 

Essential system commands. Essential commands are defined as executables 
that are needed to boot the system and mount the file systems. A full comple¬ 
ment of utilities is availableonly after /usr is mounted. 

Startup and shutdown scripts. 

Link files to scripts in /sbin/init. d for entering or leaving run level 0. 

Link files to scripts in /sbin/init. d for entering or leaving run level 1. 
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/sbin/rc2.d 

/sbin/rc3.d 

/stand 

/tmp 

/usr 

/usr/bin 

/usr/ccs 

/usr/ccs/bin 

/usr/ccs/lib 

/usr/ccs/lbin 

/usr/conf 

/usr/contrib 

/usr/contrib/bin 
/usr/contrib/include 

/usr/contrib/lib 
/usr/contrib/man 
/usr/include 

/usr/include/machine 

/usr/include/nfs 
/usr/include/sys 
/usr/lbin 

/usr/lib 

/usr/lib/nls 

/usr/local 

/usr/local/bin 

/usr/local/lib 

/usr/local/man 

/usr/newconfig 


/usr/old 
/usr/sbin 
/usr/share 
/usr/share/diet 


Link files to scripts in /sbin/init. d for entering or leaving run level 2. 

Link files to scripts in /sbin/init. d for entering or leaving run level 3. 
Standalone binaries and kernel configuration files. 

System-generated temporary files; generally cleared during the boot operation. 

Mount point for sharable user and system administration commands, libraries 
and documentation. 

Primary location for common utilities and user commands. 

C compilation system. Tools and libraries used to generate C programs. 
Development binaries; includes cc, make, strings, etc. 

Development libraries. 

Development backends. 

Kernel configuration files. 

Directory for user-contributed (unsupported, internal) commands, files, etc. 
Files in this directory come from outside the local site or organization (for exam¬ 
ple, from users groups or HP service engineers). 

User-contributed commands. 

User-contributed include files. 

User-contributed libraries. 

User-contributed man pages. 

Included header files, for C and other programs. Some subdirectories are listed 
below. 

Machine-specific C include files. 

C include files for Network FileSystem (NFS). 

Kernel related C-languageheader files. 

Directory for backend executables to other commands. A backend executable is 
an executable that is generally not invoked directly by the user. 

Program libraries, object code and architecture-dependent databases. 

Directory for NativeLanguageSupport. 

Directory for site-local commands, files, etc. Files under this directory come 
from inside the local site or organization. See /usr/contrib for non-local 
unsupported commands and files. 

Site-local commands. 

Site-local libraries. 

Site-local man pages. 

Default operating system configuration data files. This directory is a directory 
hierarchy mirroring /. New versions of customizable configuration files and 
databases are shipped here so as not to overwrite current versions. Files in this 
directory are copied to regular locations for newly installed systems. System 
administrators may wish to keep them for later reference. 

Files and programs that are being phased out or areobsolete. 

System administration commands. 

Architecture-independent sharablefiles. 

Dictionaries for spell and ispeii. 
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/usr/share/lib 
/usr/share/man 
/var 


/var/adm 

/var/adm/crash 

/var/adm/cron 

/var/adm/sw 

/var/adm/syslog 

/var/mail 

/var/news 

/var/opt 

/var/preserve 

/var/run 

/var/spool 

/var/spool/cron 

/var/spool/lp 

/var/spool/mqueue 

/var/spool/uucp 

/var/tmp 

/var/uucp 


M i seel laneous sharable libraries. 

Online documentati on. 

Root of subtree for "varying" files. These are files that are created at runtime 
and can grow to an arbitrary size. Some examples include log, temporary, tran¬ 
sient, and spool files. 

System administrative files, such as log files and accounting files. Some of the 
subdirectories are listed below. 

For saving kernel crash dumps. 

Directory for cron(lM) queuing. 

Default location for software distribution depot. 

Log files generated by syslog. See syslog(3C) and syslogd(lM). 

Incoming mail. 

Local-system news articles for news(l). 

Root of subtree for varying files associated with optional software packages. 

Place where e<(l) and vi (1) save lost edit sessions until recovered. 

Files created when daemons are running. For example, the process ID (Pi D) file 
for syslogd, syslog.pid, is put here. 

Miscellaneous directories for printer spooling, mail delivery, cron(lM), etc. 
cron(lM) and at(l) spooling files. 

Printer spool files. 

Outgoing mail and log files containing messages from the mail system. 

UUCP spool directory. 

Application-generated temporary files. This directory generally is not cleared 
between system reboots. 

UUCP administration files. 


DEPENDENCIES 

Some directories include commands or files not supported on all HP-UX implementations. 


SEE ALSO 

find(l), grep(l), ls(l), whereis(l). 
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NAME 

hostname - host name resolution description 

DESCRIPTION 

Hostnames are domains. A domain is a hierarchical, dot-separated list of subdomains. For example, the 
machine monet, in the Berkeley subdomain of theEDU subdomain of the I nternet Domain Name Sys¬ 
tem would be represented as 

monet.Berkeley.EDU 

(with no trailing dot). 

Hostnames are often used with network client and server programs, which must generally translate the 
name to an address for use. (Thistask is usually performed by the library routine gethostbyname(3).) 

When NIS or the host table is being used for hostname resolution, the hostname is looked up without 
modification. When DNS is used, the resolver may append domains to the hostname. 

The default method for resolving hostnames by the I nternet name resolver is to follow RFC 1535 's security 
recommendations. Actions can be taken by the administrator to override these recommendations and to 
have the resolver behave the same as earlier, non-RFC 1535 compliant resolvers. 

The default method (using RFC 1535 guidelines) follows: 

If the name consists of a single component, i.e. contains no dot, and if the environment variable HOS- 
TALIASES is set to the name of a file, that file is searched for a string matching the input hostname. The 
file should consist of lines made up of two strings separated by white-space, the first of which is the host- 
name alias, and the second of which is the complete hostname to be substituted for that alias. If a case- 
insensitive match is found between the hostname to be resolved and the first field of a line in the file, the 
substituted name is looked up with no further processing. 

If there is at least one dot in the name, then the name is first tried as is. The number of dots to cause this 
action is configurable by setting the threshold using the ndots option in /etc/resolv.conf (default: 
1). If the name ends with a dot, the trailing dot is removed, and the remaining name is looked up (regard¬ 
less of the setting of the’ndots'option) and no further processing is done. 

If the input name does not end with a trailing dot, it is looked up by searching through a list of domains 
until a match is found. If neither the search option in the /etc/resolv.conf file or the LOCAL- 
DOMAIN environment variable is used, then the search list of domains contains only the full domain 
specified by the domain option (in /etc/resolv.conf) or the domain used in the local hostname (see 
resolver(4)). For example, if the domain option is set to CS.Berkeley.EDU, then only CS.Berkeley.EDU 
will be in the search list and will be the only domain appended to the partial hostname, lithium, making 
lithium.CS . Berkeley.EDU the only name to be tried using the search list. 

If the search option is used in /etc/resolv.conf or the environment variable, LOCALDOMAIN, is set 
by the user, then the search list will include what is set by these methods. For example, if the search 
option contained 

CS.Berkeley.EDU CChem.Berkeley.EDU Berkeley.EDU 

then the partial hostname (eg., lithium) will be tried with each domain name appended (in the same order 
specified). The resulting hostnames that would be tried are: 

lithium.CS.Berkeley.EDU 
lithium.CChem.Berkeley.EDU 
lithium.Berkeley.EDU 

The environment variable LOCALDOMAIN overrides the search and domain options, and if both options 
are present in the resolver configuration file, then only the last one listed is used (see resolver(5)). 

If the name was not previously tried "as is" (i.e., it fell below the ndots threshold or did not contain a dot), 
then the name, as originally provided, is attempted. 

AUTHOR 

hostname was developed by the University of California, Berkeley. 

SEE ALSO 

gethostbyname(3), resolver(4), named(lM), RFC 1535. 
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NAME 

inttypes - basic integer data types 

SYNOPSIS 

#include <inttypes.h> 

DESCRIPTION 

This header file defines integer data types of various sizes. By using the data types defined in this header 
file, developers can be assured that the data types will have the same properties and behavior on different 
systems. 

Since not all implementations are required to support all of the integer sizes defined in this manual page, 
the proper way to see if a particular size of an integer is supported on the current implementation is to test 
the symbol that defines its maximum value. For example, if #ifdef UINT64_MAX tests false, then that 
implementation does not support 64-bit unsigned signed integers. 

This header file defines the foil owing integer data types for 8, 16, 32, and 64 bits. 

intmax_t largest signed integer data type supported by implementation 

int8_t 8-bit signed integer 

inti6_t 16-bit signed integer 

int32_t 32-bit signed integer 

int64_t 64-bit signed integer 

uintmax_t largest unsigned integer data type supported by implementation 

uint8_t 8-bit unsigned integer 

uintl6_t 16-bit unsigned integer 

uint32_t 32-bit unsigned integer 

uint64_t 64-bit unsigned integer 

The following two data types are signed and unsigned integer data types that are large enough to hold a 
pointer. A pointer can be moved to or from these data types without corruption. 

intptr_t signed integer type that is large enough to hold a pointer 
uintptr_t unsigned integer type that is large enough to hold a pointer 

This header file defines the foil owing integer data types for determining the most efficient data types to use 
for integer values on a particular implementation. 

intfast_t most efficient signed integer data type supported by implementation 
int_fast8_t most efficient signed integer of at least 8 bits 

int_fastl6_t most efficient signed integer of at least 16 bits 

int_fast32_t most efficient signed integer of at least 32 bits 

int_fast64_t most efficient signed integer of at least 64 bits 

uintfast_t most efficient unsigned integer data type supported by implementation 

uint_fast8_t most efficient unsigned integer of at least 8 bits 
uint_fastl6_t most efficient unsigned integer of at least 16 bits 
uint_fast32_t most efficient unsigned integer of at least 32 bits 
uint_fast64_t most efficient unsigned integer of at least 64 bits 

This header file defines the following integer data types for compatibility with systems that do not fit the 
16-bit or 32-bit word size model. These data types define the signed and unsigned integers of at least 8, 16, 
32, and 64 bits. 

int_least8_t smallest signed integer of at least 8 bits 
int_leastl6_t smallest signed integer of at least 16 bits 
int_least32_t smallest signed integer of at least 32 bits 
int_least64_t smallest signed integer of at least 64 bits 

uint_least8_t smallest unsigned integer of at least 8 bits 
uint_leastl6_t smallest unsigned integer of at least 16 bits 
uint_least32_t smallest unsigned integer of at least 32 bits 
uint_least64_t smallest unsigned integer of at least 64 bits 

The foil owing macros define the minimum and maximum values that can be stored in the above data types. 

INTMAX_MIN minimum valuethat can be stored in the largest integer data type 
INTMAX_MAX maximum valuethat can be stored in the largest signed integer data type 
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UINTMAX_MAX maximum valuethat can be stored in the largest unsigned integer data type 

INTFAST_MIN minimum valuethat can be stored in the most efficient integer data type 
INTFAST__MAX maximum valuethat can be stored in the most efficient signed integer data type 
UINTFAST^MAX maximum valuethat can be stored in the most efficient unsigned integer data type 

INT8 MIN minimum valuethat can be stored in an int8_t data type 
INT16_MIN minimum valuethat can be stored in an intl6_t data type 
INT32_MIN minimum valuethat can be stored in an int32_t data type 
INT64_MIN minimum valuethat can be stored in an int64_t data type 

INT8 MAX maximum valuethat can be stored in an int8_t data type 
INT16MAX maximum valuethat can be stored in an intl6_t datatype 
INT32_MAX maximum valuethat can be stored in an int32_t datatype 
INT64 MAX maximum valuethat can be stored in an int64_t datatype 

UINT8 MAX maximum valuethat can be stored in an uint8_t data type 
UINT16 MAX maximum valuethat can be stored in an uintl6_t data type 
UINT32_MAX maximum valuethat can be stored in an uint32_t data type 
UINT64 MAX maximum valuethat can be stored in an uint64_t data type 

INT_FAST8_MIN minimum valuethat can be stored in an int_fast8__t data type 
INTFAST16MIN minimum valuethat can be stored in an int_fastl6_t data type 
INTFAST32MIN minimum valuethat can be stored in an int_fast32_t data type 
INTFAST64MIN minimum valuethat can be stored in an int_fast64_t data type 

INT_FAST8_MAX maximum valuethat can be stored in an int_fast8_t data type 
INTFAST16 MAX maximum valuethat can be stored in an int_fastl6_t data type 
INTFAST32 MAX maximum valuethat can be stored in an int_fast32_t data type 
INTFAST64 MAX maximum valuethat can be stored in an int_fast64_t data type 

INT_LEAST8_MIN minimum valuethat can be stored in an int_least8_t data type 
INT_LEAST16_MIN minimum valuethat can be stored in an int_leastl6_t data type 
INT_LEAST32_MIN minimum valuethat can be stored in an int_least_32_t data type 
INT„LEAST64_MIN minimum valuethat can be stored in an int_least_64_t data type 

INT_LEAST8_MAX maximum valuethat can be stored in an int_least8_t data type 
INT_LEAST16_MAX maximum valuethat can be stored in an int_leastl6_t data type 
INT_LEAST32_MAX maximum valuethat can be stored in an int_least_32_t data type 
INT_LEAST64_MAX maximum valuethat can be stored in an int_least_64_t data type 

The following macros can be used as formatting options with the printf () family of functions (see 
printf(3S)). These macros are used to select the correct formatting option for the integer data types defined 
earlier in this manual page. 

PRId8 d print formatting option for int8_t 

PRIdl6 d print formatting option for inti6_t 
PRId32 d print formatting option for int32_t 
PRId64 d print formatting option for int64_t 
PRIdMAX d print formatting option for intmax_t 

PRIdFAST8 d print formatting option for int_fast8_t 
PRIdFAST16 d print formatting option for int_fastl6_t 
PRIdFAST32 d print formatting option for int_fast32_t 
PRIdFAST64 d print formatting option for int_fast64_t 
PRIdFAST d print formatting option for intfast_t 

PRIdLEAST8 d print formatting option for int_least8_t 
PRIdLEASTl6 d print formatting option for int_leastl6_t 
PRIdLEAST32 d print formatting option for int_least32_t 
PRIdLEAST64 d print formatting option for int_least64_t 

PRIi8 i print formatting option for int8_t 

PRIil6 i print formatting option for inti6_t 
PRH32 i print formatting option for int32_t 
PRIi64 i print formatting option for int64_t 

PRIiFAST8 i print formatting option for int_fast8_t 

PRIiFAST16 i print formatting option for int_fastl6_t 
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PRHFAST32 

i 

print 

PRHFAST64 

i 

print 

PRIiLEAST 8 

i 

print 

PRIiLEAST16 

i 

print 

PRHLEAST32 

i 

print 

PRHLEAST64 

i 

print 

PRIu 8 

u 

print 

PRIul 6 

u 

print 

PRIu32 

u 

print 

PRIu64 

u 

print 

PRIuMAX 

u 

print 

PRIuFAST 8 

u 

print 

PRIuFASTl 6 

u 

print 

PRIuFAST32 

u 

print 

PRIuFAST64 

u 

print 

PRIuFAST 

u 

print 

PRIuLEAST 8 

u 

print 

PRIuLEAST16 

u 

print 

PRIuLEAST32 

u 

print 

PRIuLEAST64 

u 

print 

PRI 08 

0 

print 

PRI 0 I 6 

0 

print 

PRIo32 

0 

print 

PRIo64 

0 

print 

PRIoMAX 

0 

print 

PRI 0 FAST 8 

0 

print 

PRI 0 FASTI 6 

0 

print 

PRIOFAST32 

0 

print 

PRIoFAST64 

0 

print 

PRIoFAST 

0 

print 

PRI 0 LEAST 8 

0 

print 

PRI 0 LEASTI 6 

0 

print 

PRIOLEAST32 

0 

print 

PRIoLEAST64 

0 

print 

PRIx 8 

X 

print 

PRIxl 6 

X 

print 

PRIx32 

X 

print 

PRIx64 

X 

print 

PRIxMAX 

X 

print 

PRIxFAST 8 

X 

print 

PRIxFASTl 6 

X 

print 

PRIxFAST32 

X 

print 

PRIxFAST64 

X 

print 

PRIoFAST 

X 

print 

PRIxLEAST 8 

X 

print 

PRIxLEAS T16 

X 

print 

PRIxLEAST32 

X 

print 

PRIxLEAS T 6 4 

X 

print 

PRIX 8 

X 

print 

PRIX16 

X 

print 

PRIX32 

X 

print 

PRIX64 

X 

print 

PRIXFAST 8 

X 

print 

PRIXFAST16 

X 

print 

PRIXFAST32 

X 

print 

PRIXFAST64 

X 

print 
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formatting option for int_fast32_t 
formatting option for int_fast64_t 

formatting option for int_least 8 _t 
formatting option for int_leastl 6 _t 
formatting option for int_least32_t 
formatting option for int_least64_t 

formatting option for uint 8 _t 
formatting option for uintl 6 _t 
formatting option for uint32_t 
formatting option for uint64_t 
formatting option for uintmax_t 

formatting option for uint_fast 8 _t 
formatting option for uint_fastl 6 _t 
formatting option for uint_fast32_t 
formatting option for uint_fast64_t 
formatting option for uintfast_t 

formatting option for uint_least 8 _t 
formatting option for uint_leastl 6 _t 
formatting option for uint_least32_t 
formatting option for uint_least64_t 

formatting option for int 8 _t 
formatting option for intl 6 _t 
formatting option for int32_t 
formatting option for int64_t 
formatting option for intmax_t 

formatting option for int_fast 8 _t 
formatting option for int_fastl 6 _t 
formatting option for int_fast32_t 
formatting option for int_fast64_t 
formatting option for intfast_t 

formatting option for int_least 8 _t 
formatting option for int_leastl 6 _t 
formatting option for int_least32_t 
formatting option for int_least64_t 

formatting option for int 8 _t 
formatting option for intl 6 _t 
formatting option for int32_t 
formatting option for int64_t 
formatting option for intmax_t 

formatting option for int_fast 8 _t 
formatting option for int_fastl 6 _t 
formatting option for int_fast32_t 
formatting option for int_fast64_t 
formatting option for intfast_t 

formatting option for int_least 8 _t 
formatting option for int_leastl 6 _t 
formatting option for int_least32_t 
formatting option for int_least64_t 

formatting option for int 8 _t 
formatting option for intl 6 _t 
formatting option for int32_t 
formatting option for int64_t 

formatting option for int_fast 8 _t 
formatting option for int_fastl 6 _t 
formatting option for int_fast32_t 
formatting option for int_fast64_t 
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PRIXLEAST 8 

PRIXLEAST16 

PRIXLEAST32 

PRIXLEAST64 


X print formatting option for int_least 8 _t 
X print formatting option for int_leastl 6 _t 
X print formatting option for int_least32_t 
X print formatting option for int_least64_t 


The following macros can be used as formatting options with the scanf () family of functions (see 
scanf(3S)). These macros are used to select the correct formatting option for the integer data types defined 
earlier in this manual page. 


SCNdl 6 

SCNd32 

SCNd64 

SCNdMAX 


d scan formatting option for intl 6 _t 
d scan formatting option for int32_t 
d scan formatting option for int64_t 
d scan formatting option for intmax_t 


SCNil 6 

SCNi32 

SCNi64 

SCNiMAX 


i sea n f or matt i n g opt i on f or i nt 16_t 
i scan formatting option for int32_t 
i scan formatting option for int64_t 
i scan formatting option for intmax_t 


SCNul 6 

SCNu32 

SCNu64 


u scan formatti ng opti on for uint 16_t 
u scan formatting option for uint32_t 
u scan formatting option for uint64_t 


SCN 0 I 6 

SCNo32 

SCNo64 

SCNoMAX 


o sea n f or matt i n g opt i on f or i nt 16_t 
o scan formatting option for int32_t 
o scan formatting option for int64_t 
o scan formatting option for intmax_t 


SCNxl6 

SCNx32 

SCNx64 

SCNxMAX 


x scan formatting option for intl6_t 
x scan formatting option for int32_t 
x scan formatting option for int64_t 
x scan formatting option for intmax_t 


SCNdFAST 

SCNiFAST 

SCNoFAST 

SCNxFAST 


d scan formatting option for intfast_t 
i scan formatting option for intfast_t 
o scan formatting option for intfast_t 
x scan formatting option for intfast_t 


NOTES 

The formatting options for theprintf () family of functions all begin with PRI, whereas the formatting 
options for the scanf () family of functions all begin with SCN. These formatting strings may not be 
interchangeable. 


EXAMPLES 

The foil owing example shows how to use one of the print formatting options with theprintf () function. 


uint64_t u; 


printf("u = %016" PRIx64 "\n", u); 

AUTHOR 

inttypes . h was developed by H P. 

FILES 

/usr/include/inttypes.h 

SEE ALSO 

printf(3S), scanf(3S). 
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NAME 

ioctl - generic device control commands 

SYNOPSIS 

#include <sys/ioctl.h> 
ioctl(fildes, request, arg) 
int fildes, request; 

DESCRIPTION 

The ioctl (2) system call provides for control over open devices. This include file describes requests and 
arguments used in ioctl (2) which are of a generic nature. For details about how individual requests will 
affect any particular device, see the corresponding device manual entry in Section (7). If a device does not 
support an ioctl request it returns einval. 

FIONREAD 

Returns in the long integer whose address is arg the number of characters immediately readable 
from the device file. 

FIOSSAIOSTAT 

For those character device files which support this command, if the integer whose address is arg is 
non-zero, system asynchronous I/O is enabled; that is, enable SIGIO to be sent to the process 
currently designated with fiossaioown (see below) whenever device-file-dependent events occur. 
If no process has been designated with fiossaioown, then enableSiGio to be sent to thefirst pro¬ 
cess to open the device file. 

If the designated process has exited, theSiGiO signal is not sent to any process, 
if the integer whose address is arg is 0, system asynchronous I/O is disabled. 

FIOGSAIOSTAT 

For those character device files which support this command, the integer whose address is arg is 
set to 1, if system asynchronous I/O is enabled. Otherwise, the integer whose address is arg is set 
to 0. 

FIOSSAIOOWN 

For those character device files which support this command, set process id to receive the sigio 
signals with system asynchronous I/O to the value of the integer whose address is arg. Users with 
appropriate privileges can designate that any process receive the sigio signals. If the request is 
not made by the super-user, only the calling process is allowed to designate that itself or another 
process whose real or saved effective user id matches its real or effective user id, or a process 
which is a descendant of the calling process, receive the SIGIO signals. If no process can be found 
corresponding to that specified by the integer whose address is arg, the call will fail, with errno 
set to esrch. If the request is not made by the super-user and the calling process attempts to 
designate a process other than itself or (1) another process whose real or saved effective user id 
matches its real or effective user id, or (2) a process which is not a descendant of the calling pro¬ 
cess, the call fails, with errno set to eperm. 

If the designated process subsequently exits, the sigio signal will not be sent to any process. 

The default when opening a device file is that the process performing the open is set to receive the 
SIGIO signals. 

FIOGSAIOOWN 

For those character device files which support this command, the integer whose address is arg is 
set to the process id designated to receive sigio signals. 

FIOSNBIO 

For those character device files which support this command, if the integer whose address is arg is 
non-zero, non-blocking I/O is enabled; that is, subsequent reads and writes to the device file are 
handled in a non-blocking manner (see below). If the integer whose address is arg is 0, non- 
blocking I/O is disabled. 

For reads, non-blocking I/O prevents all read requests to that device from blocking, whether the 
requests succeed or fail. Such read requests complete in one of three ways: 

• If there is enough data availableto satisfy the entire request, the read completes success¬ 
fully, having read all of the data, and returns the number of bytes read; 
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• If there is not enough data availableto satisfy the entire request, the read completes suc¬ 
cessfully, having read as much data as possible, and returns the number of bytes it was able 
to read; 

• If there is no data available, the read fails and errno is set to ewouldblock. 

For writes, non-blocking I/O prevents all write requests to that device file from blocking, whether 
the requests succeed or fail. Such a write request completes in one of three ways: 

• If there is enough space available in the system to buffer all the data, the write completes 
successfully, having written out all of the data, and returns the number of bytes written; 

• If there is not enough space in the buffer to write out the entire request, the write completes 
successfully, having written as much data as possible, and returns the number of bytes it 
was able to write; 

• If there is no space in the buffer, the write fails and errno is set to ewouldblock. 

To prohibit non-blocking I/O from interfering with the ON delay flag (see open (2) and fcntl (2)), the 
functionality of 0_ndelay always supersedes the functionality of non-blocking I/O. This means 
that if o ndelay is set, the driver performs read requests in accordance with the definition of 
ondelay. When o ndelay is not set, the definition of non-blocking I/O applies. 

The default on open of a device file is that non-blocking I/O is disabled. 

FIOGNBIO 

For those character device files which support this command, the integer whose address is arg is 
set to 1, if non-blocking I/O is enabled. Otherwise, the integer whose address is arg is set to 0. 


WARNINGS 

fiossaiostat is similar to 4.2 BSD fioasync, with the addition of provisions for security, fiogsaiostat is 
of HP origin, complements fiossaiostat, and allows saving and restoring system asynchronous I/O tty 
state for bsd style job control, fiossaioown is similar to 4.2 BSD fiosetown, with the addition of provi¬ 
sions for security, fiogsaioown is similar to 4.2 BSD fiogetown. Note also the difference that the 4.2 
BSD version of this functionality used process groups, while the hp-ux version only uses processes. 
fiosnbio is the same as 4.2 BSD fionbio, except that it does not interfere with theAT&T o ndelay open 
and fcntl flag, fiognbio is of hp origin, complements fiosnbio, and allows saving and restoring non-blocking 
I/O tty state for BSD-stylejob control. 

SEE ALSO 

ioctl(2), socket(7), arp(7). 
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NAME 

lang- description of supported languages 

DESCRIPTION 

HP-UX NLS (Native Language Support) provides support for the processing and customs requirements of a 
variety of languages. To enable NLS support for a particular language, a language definition must exist on 
the HP-UX system. Invoking the command locale -a (see locale(l)) displays information regarding 
which languages are currently supported on a particular HP-UX system. 

The default processing language for HP-UX isPOSlX. POSIX provides an environment in which process¬ 
ing occurs without NLS functionality. This environment is based on the 7-bit-coded USASCII character set. 

POSIX and C are equivalent and can be used interchangeably. 

AUTHOR 

lang was developed by HP. 

SEE ALSO 

locale(l), localedef(lM), setlocale(3C), environ(5), hpnls(5). 
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NAME 

langinfo- language information constants 

SYNOPSIS 

#include <langinfo.h> 

DESCRIPTION 

This header file contains the constants used to identify items of langinfo data (see nl_langinfo(3C)). 
The mode of items is given in <nl_types .h> . Thefollowingconstantsaredefined. (Category indicates 
in which setlocale(3C) category each item is defined). 


Constant 

Category 

Description 

CODESET 

LC_CTYPE 

Codeset name, such as iso88591 and eucJP. 

D_T_FMT 

LC_TIME 

String for formatting the %c (date and time) directive of date(l), 
getdate(3C), and strftime(3C). 

D_FMT 

LC_TIME 

String for formatting the %x (date) directive of date(l), getdate(3C), 
and strftime(3C). 

tfmt 

LC_TIME 

String for formatting the %X (time) directive of date(l), getdate(3C), 
and strftime(3C). 

T_FMT_AMPM 

LC_TIME 

Time representation in the 12 hour clock format with AM_STR and 
PMSTR. 

AM_STR 

LC_TIME 

Ante meridiem string used with 12 hour time formats (AM in 
English). 

PMSTR 

LC_TIME 

Post meridiem string used with 12 hour time formats (PM in 
English). 

DAY_1 

LC_TIME 

Name of the first day of the week (Sunday in English). 

DAY_7 

LC_TIME 

Name of the seventh day of the week. 

ABDAY_1 

LC_TIME 

Abbreviated name of the first day of the week (Sun in English). 

ABDAY_7 

LC_TIME 

Abbreviated name of the seventh day of the week. 

MON 1 

LC_TIME 

Name of the first month in the Gregorian year. 

MON 12 

LC_TIME 

Name of the twelfth month. 

ABMON_l 

LC_TIME 

Abbreviated name of the first month. 

ABMON12 

LC_TIME 

Abbreviated name of thetwelfth month. 

ERA 

LC_TIME 

The era description segments, which describe how years are 
counted and displayed for each era in a locale. Each era description 


segment has the format: 

direction : offset: startdate: 
enddate: eraname: eraformat 

according to the descriptions below. There will be as many era 
description segments as are necessary to describe the different 
eras. Era description segments are separated by semicolons. 

Note that the start of an era might not be the earliest point in the 
era; it might be the latest. For example, the Christian era BC 
starts on the day beforej anuary 1, AD 1, and increases with earlier 
time. 

direction: Either a + or a - character. The + character indicates 
that years closer to the start_date have lower numbers than 
those closer to the end_date. 

offset: The number of theyear closest to the startdate in the era. 
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start_date: A date in the format yyyy/mm/dd, where yyyy, mm, 
dd are the year, month, and day numbers respectively of the start 
of the era. Years prior to AD 1 are represented as negative 
numbers. 


ERADFMT 


ERA_D_T_FMT 

ERATFMT 

ALTDIGITS 


RADIXCHAR 


THOUSEP 


YESEXPR 

NOEXPR 

YESSTR 

NOSTR 

CRNCYSTR 


DIRECTION 


CONTEXT 


LCTIME 


LC_TIME 

LC_TIME 

LCNUMERIC 


LCNUMERIC 


LCNUMERIC 


LC_MESSAGES 
LC_MESSAGES 
LC_MESSAGES 

LC_MESSAGES 
LCMONE T ARY 


LC CTYPE 


LCCTYPE 


end_date: The ending date of the era, in the same format as the 
startdateor one of the two special values-* or +*. The value-* 
indicates that the ending date is the beginning of time. The value 
+* indicates that the ending date is the end of time. 

era_name: The era, corresponding to the %EC conversion 
specification. 

era_format: The format of the year in the era, corresponding to the 
%EY conversion specification. 

Format string for formatting the %E (Emperor/Era name and year) 
directive of date(l) and strftime(3C) if an individual era format is 
not specified for an era (see localedef(lM)). 

The locale's appropriate alternative date and time format, 
corresponding to the %Ec field descriptor. 

The locale's appropriate alternative date and time format, 
corresponding to the %EX field descriptor. 

The alternative symbols for digits, corresponding to the %0 conver¬ 
sion specification modifier. The value consists of semicolon 
separated strings. The first string is the alternative symbol 
corresponding with zero, the second string corresponding with one, 
etc. Up to 100 alternate symbol strings may be specified. 

Radix character ("decimal point" in English). The string returned is 
the same as the decimal_point element in the structure 
returned by localeconv(3C). 

Separator for thousands. The string returned is the same as the 
thousands_sep element in the structure returned by 
localeconv(3C). 

Affirmative response extended regular expression. 

Negative response extended regular expression. 

Affirmative response for yes/no questions. (Obsolete: use 

YESEXPR.) 

Negative response for yes/no questions. (Obsolete: use NOEXPR.) 

Symbol for currency preceded by - if it precedes the number, + if it 
follows the number, and . if it replaces the radix. For example, 
-DM would be used for de_DE . iso88591 (DM1234,56), + Kr 
for da_DK.iso88591 (1234,56 Kr), and .$ for 
pt_PT.iso88591 (1234$56). See localeconv(3C) for alterna¬ 
tive currency formatting information. 

Value to indicate text direction. Values currently defined include 
null, 0, and 1. Values of null or 0 indicate that characters are 
arranged from left to right within a line and lines are arranged 
from top to bottom. A value of 1 indicates that characters are 
arranged from right to left within a line and lines are arranged 
from top to bottom. (This constant is an HP proprietary item, sub¬ 
ject to change, and may not be portableto other platforms.) 

String indicating character context analysis. String null or 0 
indicates no context analysis is required. String 1 indicates Arabic 
context analysis required. 
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alt digit lc numeric A string of the characters that are mapped into the ASCII 

equivalent string 0123456789 b+- eE (where b is a blank). 
This is also the reverse mapping for output. It is not assumed that 
the character code values of digits are contiguous or that they are 
one byte values. A null value for the string indicates that the 
language has no alternative digits. (This constant is an HP 
proprietary item, subject to change, and may not be portable to 
other platforms.) 

alt_punct lc_ctype A string of the characters that are mapped into the ASCII 

equivalent string b! "#$%&' ()*+,-./: ;<=>?@ [\] { I } ~ 

(where b is a blank) in American usage. This is also the reverse 
mapping for output. It is not assumed that the character code 
values of punctuation characters are contiguous or that they are 
one byte values. If any punctuation characters do not have 
equivalent alternatives, ASCII codes are used in the alternative 
punctuation string. A null value for the string indicates that the 
language has no alternative punctuation characters. (This constant 
is an HP proprietary item, subject to change, and may not be port¬ 
able to other platforms.) 


YEAR_UNIT 

LC_TIME 

Symbol for year. This is usually required to specify date for Asian 
languages. (This constant is an HP proprietary item, subject to 
change, and may not be portableto other platforms.) 

MONUNIT 

LC_TIME 

Symbol for month. (This constant is an HP proprietary item, sub¬ 
ject to change, and may not be portableto other platforms.) 

DAY_UNIT 

LC_TIME 

Symbol for day. (This constant is an HP proprietary item, subject 
to change, and may not be portableto other platforms.) 

HOUR_UNIT 

LC_TIME 

Symbol for hour. This is usually required to specify time for Asian 
languages. (This constant is an HP proprietary item, subject to 
change, and may not be portableto other platforms.) 

MINUNIT 

LC_TIME 

Symbol for minute. (This constant is an HP proprietary item, sub¬ 
ject to change, and may not be portableto other platforms.) 

SEC_UNIT 

LC_TIME 

Symbol for second. (This constant is an HP proprietary item, sub¬ 
ject to change, and may not be portableto other platforms.) 

CHARMAP 

LC_COLLATE 

LC_CTYPE 

The name of the charmap used to compile this locale. (This con¬ 
stant is an HP proprietary item, subject to change, and may not be 
portableto other platforms.) 


WARNINGS 

It is recommended that you use strftime() to access date and time information defined in category 
(see strftime(3C)), LC_TIME and localeconv(3C) to access information corresponding to RADIXCHAR, 
THOUSEP, and CRNCYSTR (seelocaleconv(3C)). 

AUTHOR 

langinfo was developed by HP. 

SEE ALSO 

date(l), localedef(lM), getdate(3C), localeconv(3C), nl_langinfo(3C), setlocale(3C), strftime(3C), hpnls(5), 
lang(5). 
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NAME 

libcrash - crash dump access library 


SYNOPSIS 

#include <libcrash.h> 


int 

int 

cr_info_t 

int 

int 

int 

void 

int 


cr_open(const char *path, CRASH **cb, int flags); 
cr_verify(CRASH *crash_cb, int flags); 

*cr_info(CRASH *crash_cb); 

cr_uncompress(CRASH *crash_cb, const char *pathname, 
uint64_t size, int flags); 

cr_isaddr(CRASH *crash_cb, uint64_t pagenum, int *avail); 
cr_read(CRASH *crash_cb, void *buf, uint64_t mem_page, 
int *num_j?ages) ; 

cr perror(CRASH *crash_cb, int error); 
cr_close(CRASH *crash_cb) ; 


DESCRIPTION 

libcrash is a library which provides access to system crash dumps. Access to a dump through the library 
is independent of the format of the crash dump (there are several, described below). It is also independent 
of the location of the dump, which could be on a raw dump device, in files in a file system, or a mixture of 
the two. The memory of a running system can also be treated as a "dump" through use of the /dev/mem 
driver. 

All accesses to a dump through the library begin with a call to cr_open() . The crash dump descriptor 
returned from this call is a necessary parameter to all of the other libcrash calls. They are: 

cr_verify () Verifies the integrity of a dump by checking the sizes and checksums of all of the 
files making up thedump. 

cr_info () Returns a pointer to a structure containing information about the dump and the 

machine and kernel that produced it. 

cr_uncompress() 

Prepares a file in the crash dump for use, by uncompressing it (if needed) and 
validating its size and checksum. This function is used internally by the library 
for access to the physical memory image, and can be used by callers for access to 
the kernel and kernel modulefiles. 

Gives information about whether a particular physical memory page was valid 
on the machinethat dumped, and if so, whether or not that page's contents were 
included in the dump. 

Reads pages from the dump. 

Prints to standard error an error or warning message corresponding to one of 
the error or warning codes returned by another library call. 

Terminates access to the crash dump and frees all space allocated by the library. 
Each of the above calls has its own manual page, describing its usage more fully. 


cr_isaddr() 

cr_read() 
cr_perror() 

cr_close() 


Crash Dump Formats 

There are three current formats of system crash dumps: 


COREFILE (Version 0) This format, used up through HP-UX 10.01, consists of a single file containing 
the physical memory image, with a 1-to-l correspondence between file offset and memory 
address. Usually there is an associated file containingthe kernel image. 

COREDIR (Version 1) This format, used in HP-UX 10.10, 10.20, and 10.30, consists of a core, n direc¬ 
tory containing an INDEX file, the kernel (vmunix) file, and numerous core . n . m files, 
which contain portions of the physical memory image. 


CRASHDIR 

CURRENT (Version 2 — the current version) This format, used in HP-UX 11.00 and later, consists of a 
crash, n directory containing an INDEX file, thekernel and all dynamically loaded kernel 
module files, and numerous image . m. p files, each of which contain portions of the physi¬ 
cal memory image and metadata describing which memory pages were dumped and which 
were not. 
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Other formats, for exampletape archival formats, may be added in thefuture. 

RETURN VALUES 

Most of the calls in libcrash return an integer status value. A zero return value indicates success. A posi¬ 
tive return value indicates some sort of warning, despite which the requested operation was completed. A 
negative return value indicates some sort of error, which prevented completion of the requested operation. 
The values returned by the library are: 

CROK Success. 

CRWARN_NOEXPECTED The expected size or checksum of one or more files in the crash dump was 
not recorded, so the integrity of the dump cannot be verified. The dump 
might be corrupt. 

CRWARN__NOACTUAL The checksum of one or more files in the crash dump could not be com¬ 
puted, so it could not be checked against the expected value. The dump 
might be corrupt. 

CRWARN SWAPPEDON A raw device containing a portion of the crash dump has been swapped on, 
so the dump is probably corrupt. 

CRWARN_MISMATCH The size or checksum of one or more files in the crash dump did not match 
what was expected. The dump is probably corrupt. 

CRERR_NOPAGE A read or write request was issued for a memory address that does not 

exist on the target machine. 

CRERR_READONLY A write request was issued for a crash dump. Writes are supported only 
to running systems through the /dev/mem driver. 

CRERR_WRONGDUMP A raw dump device which is supposed to contain part of the dump does 
not. It may have been overwritten by swap activity or by a more recent 
dump. 

CRERR_WRONGHOST A portion of the crash dump still resides on a dump device of the system 
that dumped, which is not the current system. 

CRERR_ERRNO A system error occurred. Consult errno for the specific error. Note 

that certain values for errno have specific meanings in the context of 
thelibrary. They include: 

[ENOEXEC] A portion of the crash dump could not be uncompressed. 

[ENOTDIR] The specified pathname for the dump was neither a plain 
file, nor a directory containing an INDEX file, nor the 
/dev/mem pseudodriver. 

\ Other values of errno have their traditional meanings. 

AUTHOR 

libcrash was developed by HP. 

SEE ALSO 

cr_dose(3), cr_info(3), cr_isaddr(3), cr_open(3), cr_perror(3), cr_read(3), cr_uncompress(3), cr_verify(3). 
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NAME 

limits - implementation-specific constants 

SYNOPSIS 

include <Jimits.h> 


DESCRIPTION 

The following symbols are defined in <limits.h> and are used throughout the descriptive text of this 
manual. The column headed hp-ux Value lists the values that application writers should assume for porta¬ 
bility across all hp-ux systems. 

Symbols after values are interpreted as follows: 

+ Actual limit might be greater than specified valueon certain hp-ux systems. 

Actual limit might be less than the specified valueon certain hp-ux systems. 

= Actual limit is always equal to the specified value and does not vary across hp-ux systems. 

* The name of this limit is defined only if the preprocessor macro _XPG2 is defined, either by the 
compilation flag -D XPG2, or by a ^define directive in the source before <dimits.h>is included in 
the source. 

# The value defined for this limit might not be a compile-time constant. The value defined always 
evaluates to an integer expression at run time. 

Some of these limits vary with system configuration, and can be determined dynamically by using sys- 
conf(2). Others can vary according to file system or device associated with a specific file, and can be deter¬ 
mined with pathconf(2). Others are obsolescent because they are redundant with other limits or not useful 
in portable applications. They are provided only for importability of applications from other systems, to 
support applications that comply with the X/Open Portability Guide, Issue2, and for backward compatibil¬ 
ity with earlier versions of hp-ux. The_XPG2 flag should not be defined in new applications. 

By including the <dimits.h>file in the compilation an application can test the appropriate limits to deter¬ 
mine whether it can operate on a particular system, or it might even alter its behavior to match the system 
to increase its portability across a varying range of limit settings and systems. 

Constant Description HP-UX Value 


ARG MAX 

CHAR BIT 
CHAR MAX 
CHAR MIN 
CHILD MAX 

CLK TCK 
DBL DIG 
DBL MAX 
DBL MIN 
FCHR MAX 
FLT DIG 
FLT MAX 
FLT MIN 
I NT MAX 
I NT MIN 
LINE MAX 
LINK MAX 
LOCK MAX 
LONG BIT 
LONG MAX 
LONG MIN 
MAX CANON 

MAX CHAR 
MAX INPUT 


Max length of arguments to e<ec(2) in bytes, 

including environment data 

Number of bits in a char 

Max integer value of a char 

Min integer value of a char 

Max number of simultaneous processes per user 

ID 

Number of clock ticks per second 

Digits of precision of a double 

Max positive value of a double 

Min positivevalueof a double 

M ax file offset in bytes 

Digits of precision of a float 

Max positive value of a float 

Min positive valueof a float 

Max decimal valueof an int 

Min decimal valueof an int 

Max number of characters in a singleline 

Max number of links to a singlefile 

Max number of entries in system lock table 

Number of bits in a long 

Max decimal valueof a long 

Min decimal valueof a long 

Max number of bytes in terminal canonical input 

line 

Max number of bytes in terminal input queue 
Max number of bytes in terminal input queue 


5120 -4* 

8 = 
127 = 
-128 = 
25 +-* 

50 +# 
15 + 

1.7976931348623157e+308 + 

4.94065645841246544e-324 - 
INT MAX +-* 
6 + 

3.40282346638528860e+38 + 
1.40129846432481707e-45 - 
2147483647 + 
-2147483648 - 
2048 = 
32767 -4* 
32 +-* 
32 + 

2147483647 + 
-2147483648 - 
512 -4* 

MAX INPUT =* 
512 4* 
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name max M ax number of bytes i n a path name component 

nl argmax M ax value of "digits" in calls to the nls pri ntf(3S) 

and scanf(3S) functions 

nl msgmax M ax message number in an nls message catalog 
nl setmax M ax set number in an nls message catalog 
nl textmax M ax number of bytes in an NLS message string 

ngroups max M ax number of supplementary groups per process 

open max Max number of files a process can have open 

pass max M ax number of chars in a password 

path max Max number of characters in a path name exclud¬ 

ing the null terminator 
pi d max Max value for a process id 

pipe buf Max number of bytes atomic in write to a pipe 

pipe max Max number of bytes writable to a pipe in one 

write 

proc max M ax number of simultaneous processes on system 
schar max Max integer value of a signed char 

schar min Min integer value of a signed char 

sh rt_max Max decimal value of a short 

shrt_min Min decimal value of a short 

std blk Number of bytes in a physical I/O block 

syspi d max M ax process ID of system processes 
sys nmln Length of strings returned by uname(2) 
sys open M ax number of files open on system 

tmp max Max number of unique names generated by 

tmpnam(3S) 

uchar max Max integer valueof an unsigned char 

uid max Smallest unattainablevaluefor a user or group id 

u int max Max decimal valueof an unsigned int 

ulong max Max decimal valueof an unsigned long 

ushrt max Max decimal valueof an unsigned short 

usi max Max decimal valueof an unsigned int 

word bit Number of bits in a "word" (int) 


14 -4* 
9 = 

32767 + 
255 + 
8192 + 
20 + 
60 4* 
8 + 
1023 4* 

30000 4- 
8192 4* 
INT MAX 4- 

84 4-* 
127 = 
-128 = 
32767 4- 
-32768 - 
512 4- 
4 4-* 
84* 
120 4-* 
17576 4- 

255 = 
2147483647 4- 
4294967295 4- 
4294967295 4- 
65535 4- 
UI NT MAX =* 
32 4- 


EXAMPLES 

uid_max has an hp-ux valueof 2147483647 4-, which means that on all hp-ux systems the smallest unat¬ 
tainable value for a user or group id is at least 2147483647. A particular system might be capable of sup¬ 
porting more than 2147483647 user or group ids, in which case its <Jimits.h>file sets uid max to a higher 
value; however, any application assuming such a higher value is not guaranteed to be portableto all hp-ux 
systems. 

AUTHOR 

I i mi ts was devel oped by H P. 


SEE ALSO 

exec(2), fcntl(2), fork(2), getgroups(2), link(2), lockf(2), open(2), pathconf(2), sysconf(2), uname(2), write(2), 
printf(3S), scanf(3S), tmpnam(3S), passwd(4), values(5), termio(7). 

Series 700 config(lM). 


STANDARDS CONFORMANCE 

<Limits.h>: AES, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, POSIX.2, ANSI C 
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NAME 

man - macros for formatting manpages 

SYNOPSIS 

man file ... 

nroff -man [option]... [file]... 

DESCRIPTION 

The man macros are used by the man and nroff commands (see man(l) and nroff(l)) — and are usable 
by troff (see third-party documentation) — to format the on-line versions of manpages found in HP-UX 
Referenceand other related reference manuals. The man command callsnroff. 

man and nroff Defaults 

The default page size is 85 characters by 66 lines (8.5x11 inches), with a 75-character by 60-line text area. 
Hyphenation is turned off and paragraphs are left-adjusted, ragged-right. 

troff Defaults 

The default page size is 8.5x11 inches with a 6.5xl0-inch text area. The type size is 10 points and the verti¬ 
cal line spacing is 12 points. Hyphenation isturned on and paragraphs arejustified left and right. 

Other Defaults 

Type font and size are reset to default values before each paragraph and after processing font- and size¬ 
setting macros such as . I, .RB, and . SM. Tab stops are neither used nor set by any macro except .DT 
and .TH. The .TH macro invokes .DT (see below). 

Options 

The following options can be specified for nroff or troff. They are not permitted for the man com¬ 
mand. 

-rsl Reduce the dimensions for troff to a page size of 6x9 inches with a 4.75x8.375-inch text area, 
the type size to 9 points, and the vertical line spacing to 10 points. This option is ignored by 
nroff. 

-rV2 Set certain parameters to values appropriate for certain Versatec printers: line length to 82 
characters (ens); page length to 84 lines; underlining inhibited. Do not confuse this option with 
the — Tvp option of theman command, which is availableon some operating systems, but not on 
HP-UX. 

Summary of Macros, Strings, and Numbers 

The defined man macros, strings, and numbers are summarized here and described in detail in the follow¬ 
ing subsections. 

.B Set text in bold. 

.BC Set words alternately in bold and constant-width. 

. BI Set words alternately in bold and italics. 

.BR Set words alternately in bold and roman. 

. C Set text in constant-width. 

. CB Set words alternately in constant-width and bold. 

. CD I dentify command name. 

. Cl Set words alternately in constant-width and italics. 

. CR Set words alternately in constant-width and roman. 

.CT Identify citation title. 

.DT Restore default tab settings. 

. EM I dentify emphasis. 

.ER Identify error name. 

.EV Identify environment variablename. 

. GT I dentify glossary term. 

.HP Begin paragraph with hanging indent. 

.1 Set text in italics. 

. IB Set words alternately in italics and bold. 

. IC Set words alternately in italics and constant-width. 

. IP Begin indented paragraph with optional tag. 
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. IR Set words alternately in italics and roman. 

.KC Identify keycap. 

.P Begin normal paragraph. 

.PD Set interparagraph spacing. 

.PM Use Bell System proprietary subfooters. 

.PP Begin normal paragraph. 

.RB Set words alternately in roman and bold. 

.RC Set words alternately in roman and constant-width. 

.RE End relative margin indent. 

. RI Set words alternately in roman and italics. 

.RS Start relative margin indent. 

.RV Identify return value. 

. S3 Insert third level header. 

. SC I dentify system constant name. 

. SH Insert section header. 

.SM Print text one point smaller. 

. SS I nsert subsection header. 

. TH Start new manpage and define page headers and footers. 

.TP Begin tagged paragraph. 

\*R Registered trademark. 

\*S Change to default type size. 

\* (Tm Trademark. 

\n (IN Left text margin; default margin indent and paragraph indent. 

\n(LL Line length, including \n (IN. 

\n (PD I nterparagraph distance. 

■ Macro Parameters 

All macro parameters are positional and can be omitted, starting from the right. Each parameter is a 
word, as described below. 

m mi Margin increment. This is the amount by which the left text margin will be increased. If it is 

omitted, it defaults to \n(lN basic units (u). The default measure for mi is ens (n). The left 
text margin's base value is \n (IN. 

in Paragraph indent. This is the amount by which indented lines of a paragraph will be indented. 

If it is omitted, it defaults to the valuethat was established by the most recent paragraph macro: 
explicitly or default by .HP, .IP, or . TP; implicitly by .P, .PP, .RE, or .RS. The default 
measure for in is ens (n). 

text Consists of zero to six words. If text is empty, the special treatment is applied to the next line 
containing text to be printed. For example, . I can be used to italicizea whole line, or .SM fol¬ 
lowed by .B to make small bold text. 

word A string of characters separated by spaces (not tabs). Use quotation marks ("[word]") to include 
spaces in a word ("string string") or to specify a null word (""). (The nonbreaking, nonpadd- 
able space (\ ) is not a separating space.) 

Header Macros 

.TH tl s2 c3 n4 a5 

Set thetitleand entry heading, tl, s2, c3, n4, and a5 are words, 
tl Entry title. 

s2 Section number, tl is combined with s2 in parentheses to form the top left- and righthand 
corners of the page heading. 

c3 Extra commentary, such as "Optional Software Required". It is placed at the center of the 
bottom linein the two- or three-line page heading space. 

n4 Other notations, such as "Series 300/400Only". It iscentered between thetitleand section 
on the first page heading line. 

a5 Support for alternate naming, such as a FORTRAN routine name corresponding to a C 
function name specified in tl. 
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The resulting output is in theform: 


tl(s2) n4 tl(s2) 

a5 a5 

c3 


. SH text Place section head text, such as SYNOPSIS, here. Section headings start at the left margin. 
Since they are normally all uppercase, they are printed a point-size smaller in trof f. 

. SS text Place subsection head text, such as Options , here. Subsection headings start between the left 
margin and the normal text indent. 

.S3 text Place third-level head text, such as subhead, here. Third-level headings start at the normal text 
indent. 

Paragraph Macros 

.P 

.PP Begin a block paragraph. Reset in to \n(lN, "cancelling" any value set by previous .HP, .IP, 
and .TP macros. 

.HP in Begin a paragraph with hanging indent. The text begins at the current margin. Thesecondand 
following output lines are indented. 

.TP in Begin an indented paragraph with hanging tag. The next input line that contains text to be 
printed is taken as the tag. The tag begins at the current margin. If the tag fits in the indent, 
the paragraph text begins at the indent position on the same line. If the tag does not fit in the 
indent, the paragraph text begins at the indent position on the next line. 

.IP t in Same as .TP inwithtagt. Often used to get an indented paragraph without a tag. 

.RS mi I ncrease the current left margin by mi. If mi is omitted, it defaults to the current value of in. 

Set the paragraph indent, in, for the new margin level to \n(lN. You can specify up to nine 
.RS increment levels. Margin increments can be backed out with the .RE macro and are reset 
to the base margin by the . TH, . SH, . SS, and . S3 header macros. 

.RE k Return to the kth left margin setting (initially, k=l; k=0 is equivalent to k=l). If k is omitted, 

return to the previous margin value. The paragraph indent, in, is restored to the value it had 

prior to the corresponding .RS macro. 

.PD pd Set the interparagraph distance to pd vertical spaces. If pd is omitted, set the interparagraph 
distance to the default value: 1 line in nrof f. 0.4 line in trof f. The measure for pd is verti¬ 
cal line spaces (v). 

Font Macros 

.B text Set text in bold. 

.C text Set text in constant-width font. See the WARNINGS section. 

. I text Set text in italic. 

(There is no . R (roman) macro, but you can use one of the .XY combinations if need be.) 

.XY a b Concatenate a in font X with b in font Y and alternate these two fonts for up to six words. The 

font letters X and Y can beB (bold), C (constant-width), I (italic), and R (roman), in thefollowing 

combinations: 



.CB 

. IB 

.RB 

BC 


. IC 

.RC 

BI 

.Cl 


. RI 

BR 

.CR 

. IR 



For more about constant-width font, see the WARNI NGS section. 

.SM text Make text one point smaller than the default point size. This has no effect in nrof f. 

Special Macros 

These macros identify common text elements in manpages. They aid in providing consistent font usage in 
the HP style and in improving conversion to other formatting systems. 
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The first parameter is set in an appropriate font or format. The second parameter, punctuation, is set in 
roman font and is provided for concatenated punctuation. The two parameters are concatenated as with 
the font macros. 

.CD commandname punctuation 

commandnameis a command name, usually defined in a section 1 or 1M manpage, such as man. 
It is displayed in constant-width font. 

.CT citationtitle punctuation 

citationtitle is the name of a document, such as HP-UX Reference. It is displayed in italics. (Use 
the standard . IR macro for manpage references.) 

.EM emphasis punctuation 

emphasis is a word or phrase that you want to emphasize, such as Do not. Use emphasis spar¬ 
ingly. It is displayed in italics. (Use the standard . I macro for variable names.) 

.ER errorname punctuation 

errorname is an error name that corresponds to a value assigned to errno by a function and 
described in the ERRORS section of a manpage. It is displayed in roman, enclosed in square 
brackets. For example, .ER EIO . is displayed as [El O], 

.EV environvarname punctuation 

environvarname is the name of an environmental variable, such as PATH. It is displayed in 
constant-width font. 

.GT glossterm punctuation 

glossterm is a glossary term, or a term that you are defining for later use in the manpage, such 
as path name. It is displayed in bold. 

.KC keycap punctuation 

keycap is the name of a keyboard key, such as Tab. It is displayed in bold. 

.RV rdturnvalue punctuation 

returnvalue is a numerical return value of a function or exit status of a command, usually as 
defined in a RETURN VALUE or EXIT STATUS section. It is generally used for number expres¬ 
sions, such as 0, >3, and <>0, but not for word descriptions, such as "nonzercf. It is displayed 
in constant-width font. 

.SC systemconstant punctuation 

systemconstant is an operating system constant name, such as PATH__MAX. It is displayed in 
constant-width font. See getconf(l). 

Other Macros 

.DT Restore default tab settings: every 5 ens in nroff ; every 3.6 ems in troff. 

.PM sf Produce Bell System proprietary subfooters. 

sf produces 

P PRIVATE 
N NOTICE 

BP BELL LABORATORIES PROPRIETARY 
BR BELL LABORATORIES RESTRICTED 

Strings 

The foil owing string references are defined: 

\*R Registered Trademark symbol: displayed as (Reg.) in nroff, and using the \ (rg inline 
macro in troff. 

\*S Change to default type size. This is executed as a \s inlinemacro. 

\* (Tm Trademark indicator, TM, displayed as a superscript if possible. 

Numbers 

The following number references are defined: 

\n (IN Left text margin indent relative to section heads and default value for mi and in: 5 ens in 
nroff; 3.6 ems in troff. IN is expressed in basic units (u). 
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\n(LL Line length including \n(IN: 75 characters in nroff; 6.5 inches in troff. Also see the 
Options subsection. LL is expressed in basic units (u). 

\n (PD Current interparagraph distance. Set by. PD. PD is expressed in vertical linespaces (v). 

Measure 

nroff and troff use a number of scale indicators to qualify horizontal and vertical measurements. 
Many macro parameters have default units of measure. Because all assignments to numeric variables are 
converted to basic units (u), it is important to take care in assigning and referencing values. 


Scale 

Indicator Measure 

Basic Units 

nroff troff 

C 

centi meter 

240/2.54 

D/2.54 

i 

inch 

240 

D 

m 

em 

C 

p*S 

n 

en =em/2 

C 

p*S/2 

P 

point = 1/72 inch 

240/72 

D/72 

P 

pica = 1/6 inch 

240/6 

D/6 

u 

basic unit 

1 

1 

V 

vertical linespace 

V 

V 


C Character width of output device. 

D Dots per inch (dpi) of output device. 

S Current type size in points. 

V Current vertical linespacing in basic units. 

Font Conventions 

Entries in the HP-UX Reference use the foil owing font conventions: 

roman Regular typeface. 

italic Used for variables and other words that represent an argument that may 

takeon a user-defined or variablevalue. Also used for emphasis. 

boldface Used primarily in headings and occasionally for terms when first intro¬ 

duced or when being defined. 

constant-width Used for all literalsthat are typed exactly as shown when used as keyboard 
commands or command-line options, in programs, etc. 


Page Footers 

The strings used in the page footer are initialized by the . TH macro. ) H defaults to a nonprinting (null) 
string. ]W defaults to the date the manpage is formatted, as in Formatted: July 5, 1995. In HP 
manpages, ) H is set to the company name, "Hewlett-Packard Company"; ] W is set to release information, 
as in "HP-UX Release 10.10: November 1995". 

This arrangement enables users and third-party software suppliers to directly control the contents of the 
left- and right-hand fields of the footer line for use in displaying company name, release version, etc., as 
desired when creating their own manual entries. )H is printed on the left, ]W is printed on the right, and 
the page number is printed in the center. These strings can be defined anywhere after the . TH macro call, 
provided they appear before the end of the first page. For example, the foil owing source file segment: 

.TH man 5 

.ds )H XYZ Company 

.ds ]W Release 2.3: May 1996 

produces a footer with text in the form: 


XYZ Company -1- Release 2.3: May 1996 


Tables 

The tbl preprocessor (see tbl (1)) can be used to insert tables in manpages. The man macros allow you to 
use the standard tbl macros: .TS, .T&, and .TE. They do not support the mm macro extensions, 
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. TS H and .TH (seemm(5)). 

In general, avoid using the man macros within a table, particularly the font macros, which can produce 
peculiar and unpredictable results. Use the nroff/troff intrinsic macros instead. For example, to 
specify bold type, use the in-linemacro \fB, or, more generally, \f3. To insert horizontal blank lines, you 
can use the . PP or . IP macro, depending on which one preceded the table, but you must then avoid using 
the center and expand tableformat specifications. Otherwise, indentation will be erratic. 

WARNINGS 

HP no longer uses the NAME section to prepare the Table of Contents and I ndex for the printed manual. 
Instead, that information is coded as comments at the end of each manpage source file where it can be 
accessed by various tools and programs as desired. The NAME section is still used for the whatis data¬ 
base, as described below. 

The macro package used to print the HP-UX Reference increases the interword spaces (to eliminate ambi¬ 
guity) in the SYNOPSIS section of each entry. 

In addition to the macros, strings, and number registers mentioned above, a number of internal macros, 
strings, and number registers are defined. These include 

• The names predefined by the nroff/troff processor. 

• The macro th, 

• The number register :m, 

• Macro, string, and number names in theforms ) x, ] x, and }x, where x stands for some alphanumeric 
character, 

• Macro, string, and number names in the form XY, where X and Y are capital letters. 


Fonts 

nroff uses only three fonts: roman, italic, and bold, designated as font positions 1, 2, and 3, respectively. 
The constant-width font macros in the macro package (. C, .RC, .IC, .BC, .CR, .Cl, .CB) simulate a 
constant-width font with the bold font, sinceall nroff output is constant width or typewriter format. 

To use a true constant-width font with troff , change the corresponding font 3 specification in each 
constant-width font macro to font 4 and mount a constant-width font in position 4 using a troff .fp 
request, as in: 

.fp 4 CW 

The whatis Database 

The NAME section of each manpage is processed by catman (see catman(lM)) to create an entry in the 
whatis database, which is used by the -f and -k options of the man command, catman processes the 
lines of the NAME section into a single line in the format: 

name[, name]... - explanatory-text 

Hyphens (typed as - or \-), en-dashes (\ (mi), and em-dashes (\ (em) are treated equivalently. The last 
space-hyphen-space in the line becomes the dividing point between names and explanatory text. 

FILES 

/usr/share/lib/macros/an 
The man macros. 

/usr/share/lib/tmac/tmac.an 

Called by man. Sources (.so) the macros in /usr/share/lib/macros/an. Other macro files 
can be specified here to accommodate manpages with additional macro requirements. 

/usr/share/lib/whatis 

File of strings from manpage NAME sections, created by catman, and used by the man -k and -f 
options. 

SEE ALSO 

col(l), man(l), neqn(l), nroff(l), tbl(l), catman(lM), mm(5). 
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NAME 

manuals - current list of HP-UX documentation 

DESCRIPTION 

This entry contains a list of current English language manuals for the HP-UX operating system. It also 
listsj apanese, Korean, and Chinese NLIO manuals. 

The information is current as of HP-UX release 11.0. Manuals updated after release 11.0 may have 
different part numbers. Contact your HP Sales and Support office for assistance on getting the correct edi¬ 
tions of manuals for your system. If discrepancies are encountered between system behavior and a given 
manual, verify the edition date to ensure that the manual is current. 

Applications software manuals are not included in this list. 

Ordering Information 

For information about how to order any of these manuals, as well as other HP computer and calculator 
manuals and supplies, call Parts Direct Ordering toll-free in the U nited States at 1-800-227-8164; or, if out¬ 
side the U.S.A., contact your nearest HP Sales and Support office for information about ordering these 
manuals or versions of these manuals in other languages. 

Manual List 

Stock Number Title 


28604-90001 

32055-90001 

32055-90002 

32070-90030 

32070-90031 

32070-90032 

32070-90033 

36960-90050 

5963-4146 

5963-4416 

5963-4467 

5963-4468 

5963-4475 

5963-4519 

5963-8917 

5963- 8942 

5964- 1320 

5964- 1365 

5965- 4409 
5965-4445 
5965-4446 
5965-4447 
5965-4448 
5965-4462 
5965-4463 
5965-4464 
5965-4465 
5965-4629 
5965-4641 
5965-4642 

5965- 4643 

5966- 8634 
5966-9847 

5966- 9852 

5967- 0055 
5967-0056 
92431-90005 
92431-90006 
92432-90011 
92434-90002 


HP OSI Express 802.4 Hardware 

HP X.400/HP Desk Administration Guide 

Using Hp DeskMgr Connection X 

I nstalling and Administering OSI Transport Services 

HP OSI Troubleshooting Guide 

ACSE/Presentation and ROSE I nterface Programmer's Guide 
Release Notes: OTS 9000 10.0 

Programmer's Guide to X.25 Link Software for HP9000Systems 

HP ATM/9000 Adapter for HSC Servers Config & Troubleshooting 

C++Customer Survey 

C/HP-UX 10.0 Release Notes 

C/HP-UX Technical Addendum 

HP-UX Programming Tools Release Notes 

FORTRAN/9000 Release Notes 

HP Pascal/HP-UX ReleaseNotes 

HP-UX 10.0 FileSystem Layout Whitepaper 

HP Micro Focus COBOL Release Notes S700/800 

HP-UX 10.10 Release Notes (On-Lineand LRom only) 

HP-UX Programming Tools Release Notes 
HP Fortran 90 Release Notes 
C/HP-UX Developer's Bundle Rel ease Notes 
HP Micro Focus COBOL ReleaseNotes 
Nihongo COBOL ReleaseNotes 
J AVA Developer's Kit Release Notes 
J AVA Virtual MachineRelease Notes 
J AVA J IT Rel ease N otes 
HP Pascal/HP-UX ReleaseNotes 
HP aC++Customer Survey 

HP-UX Memory Management White Paper (replaced at 11.0) 
HP-UX Process Management White Paper (replaced at 11.0) 
HP-UX Multi-Processing White Paper 

ATM/622 & ATM/155 Adapters Config and Troubleshooting Guide 
HP C++12.0 (cfront) Release Notes 
HP aC-H-Release Notes 

Release Notes for HP-UX 11.0 (On-Lineand CD-ROM only) 
HP-UX 11.0 Documentation Map WhitePaper 
HP Pascal/HP-UX Reference Manual 
HP Pascal/HP-UX Programmer Guide 
Assembly Language Reference Manual 
HP C Programmer's Guide 
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92453-90024 
92552-90009 
92668-90006 
92668-90007 
97005-90015 
98194-90053 
A4011-90003 
A4011-90006 
B1011-90003 
B1014-90012 
B1031-90002 
B1033-90004 
B1033-90014 
B1033-90024 
B1033-90034 
B1033-90040 
B1171-90078 
B1171-90101 
B1171-90102 
B1171-90104 
B1171-90105 
B1171-90106 
B1171-90108 
B1171-90109 
B1171-90126 
B1171-90135 
B1171-90136 
B1171-90141 
B1171-90145 
B1171-90146 
B1171-90147 
B1171-90148 
B1171-90149 
B1171-90150 
B1171-90151 
B1171-90152 
B1171-90153 
B1171-90154 
B1171-90155 
B1171-90156 
B1171-90157 
B1171-90158 
B1171-90159 
B1171-90161 
B1171-90162 
B1171-90163 
B1171-95101 
B1171-95102 
B1171-95141 
B1171-96101 
B1171-96102 
B1171-96141 
B1171-97101 
B1171-97102 
B1171-97141 
B1171-98101 
B1171-98102 
B1171-98141 
B1171-99101 
B1171-99102 
B1171-99141 
B 2200-90019 


HP C/HP-UX Reference Manual 

NLIO I nput Method Guide (Trad. Chinese) 

Managing SwitchOver/UX 

Read Me Before Upgrading SwitchOver/UX from HP-UX 9.0 to HP-UX 10.0 

The Ultimate Guide to vi and ex Editors 

LLA Programming & Migration Guide 

Token Ring Series 712 Quick I nstallation 

I nstalling and Administering Token Ring 

Using LAN Manager/X 

DTC Device File Access Utilities and Telnet Port Identification 

I nstalling & Administering NFS Services 

HP FTAM/9000 Reference Manual 

HP FTAM/9000 Programmer's Guide 

HP FTAM/9000 User's Guide 

I nstalling and Administering HP FTAM/9000 

FTAM/9000 Technical Addendum 

HP Xlib Extensions (CD-ROM only) 

CDE 1.0 User's Guide 

CDE 1.0 Advanced User's and System Administrator's Guide 

HP CDE Getting Started Guide 

CDE Programmer's Overview 

CDE Programmer's Guide 

CDE Desktop Korn Shell User's Guide 

CDE Help System Author's and Programmer's Guide 

CDE ToolTalk Programmer's Guide 

HP CDE Getting Started Guide Addendum for 10.30 

Technical Print Service System Administration's Guide (CD-ROM only) 

HP CDE Getting Started Guide 

Motif Programmer's Guide Release 2.1 (CD-ROM only) 

Motif User's Guide Release 2.1 (CD-ROM only) 

Motif and CDE Style Guide Reference (CD-ROM only) 

Motif and CDE Style Guide (CD-ROM only) 

Motif and CDE Style Guide and Certification Checklist (CD-ROM only) 

Motif Widget Writer's Guide (CD-ROM only) 

Motif Master Glossary (CD-ROM only) 

CDE Programmer's Overview (CD-ROM only) 

CDE Programmer's Guide (CD-ROM only) 

CDE Help System Author's and Programmer's Guide (CD-ROM only) 

CDE Internationalization Programmer's Guide (CD-ROM only) 

CDE Desktop Korn Shell User's Guide (CD-ROM only) 

CDE ToolTalk Messaging Overview (CD-ROM only) 

Guide to the DocBook DTD (CD-ROM only) 

CDE Product Glossary (CD-ROM only) 

CDE 2.1 User's Guide (CD-ROM only) 

CDE 2.1 Advanced User's and System Administrator's Guide (CD-ROM only) 
CDE ToolTalk Programmer's Guide (CD-ROM only) 

CDE 1.0 Users Guide (French) 

CDE1.0 System Administration Guide (French) 

CDE2.1 Getting Started (French) 

CDE 1.0 Users Guide (German) 

CDE 1.0 System Administration Guide (German) 

CDE2.1 Getting Started (German) 

CDE1.0 Users Guide (Spanish) 

CDE 1.0 System Administration Guide (Spanish) 

CDE2.1 Getting Started (Spanish) 

CDE1.0 Users Guide (Italian) 

CDE1.0 System Administration Guide (Italian) 

CDE2.1 Getting Started (Italian) 

CDE 1.0 Users Guide (Swedish) 

CDE 1.0 System Administration Guide (Swedish) 

CDE2.1 Getting Started (Swedish) 

J apaneseNLIO Manual 
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B 2204-90002 
B 2204-90011 
B 2208-90011 
B 2208-90012 
B 2212-90002 
B 2212-90003 
B2212-90011 
B 2355-90046 
B 2355-90049 
B 2355-90060 
B 2355-90063 
B 2355-90068 
B 2355-90069 
B 2355-90072 
B 2355-90086 
B 2355-90087 
B 2355-90088 
B 2355-90088 
B 2355-90092 
B 2355-90093 
B 2355-90094 
B 2355-90095 
B2355-90112 
B 2355-90133 
B 2355-90134 
B 2355-90140 
B 2355-90153 
B 2355-90154 
B 2355-90155 
B 2355-90156 
B 2355-90157 
B 2355-90158 
B 2355-90159 
B 2355-90160 
B 2355-90161 
B 2355-90162 
B 2355-90163 
B 2355-90164 
B 2355-90166 
B 2355-90655 
B2355-95153 
B2355-95154 
B 2355-95157 
B 2355-95158 
B 2355-95164 
B 2355-96153 
B 2355-96154 
B 2355-96155 
B 2355-96156 
B 2355-96157 
B 2355-96158 
B 2355-96164 
B 2433-90029 
B 2433-90031 
B 2433-90056 
B2433-90057 
B 2433-90058 
B 2433-90059 
B 2433-90060 
B 2433-90061 
B 2433-90062 
B 2433-90063 


NLIO System Admin Guide (Kor.) 

NLIO Access User's Guide (Kor.) 

NLIO Access User's Guide (Trad. Chinese) 

NLIO System Admin Guide (Trad. Chinese) 

NLIO System Admin Guide (Simp. Chinese) 

NLIO I nput Method Guide (Simp. Chinese) 

NLIO Access User's Guide (Simp. Chinese) 

Shells: User's Guide 
POSIX Conformance Document 
Programming with Threads on HP-UX 
Kermit Mailer Card 

Using the I mage Developer's Kit (CD-ROM only) 

Using the Audio Developer's Kit (CD-ROM only) 

Technical Addendum to the Shells: User's Guide 

I nstalling HP-UX 10.10 and U pdating 10.Ox to 10.10 

I nstallingSi Administering LAN/9000 

Using Serial Line IP Printers 

Using Serial Line IP Protocols 

BSD Socket I nterface Programmer's Guide 

DLPI Programmer's Guide 

XTI Programmer's Guide 

BSD Socket Quick Reference Guide 

Quick Guide to I nstalling HP-UX 10.20 

I nstalling & Administering I nternet Services 

Using I nternet Services 

Networking Overview 

I nstalling HP-UX 11.0 and Updating 10.x to 11.0 

Managing HP-UX Software with SD-UX 

HP-UX Distributed Print Service Administration Guide 

HP-UX Distributed Print Service User's Guide 

M anagi ng Systems and Workgroups 

Configuring HP-UX for Peripherals 

HP-UX Reference Vol 1 (11.0) 

HP-UX Reference Vol 2 (11.0) 

HP-UX Reference Vol 3(11.0) 

HP-UX Reference Vol 4 (11.0) 

HP-UX Reference Vol 5 (11.0) 

Using HP-UX 

HP-UX Reference (5 Volume Customer Order Number) 

HP-UX Linker and Libraries User's Guide 
I nstalling HP-UX 11.0 & Updating 10.x to 11.0 (French) 
Managing HP-UX Software with SD-UX (French) 

M anagi ng Systems and Workgroups (F rench) 

Configuring HP-UX for Peripherals (French) 

Using HP-UX (French) 

I nstalling HP-UX 11.0 & Updating 10.x to 11.0 (German) 
Managing HP-UX Software with SD-UX (German) 

HP-UX Distributed Print System User's Guide (German) 

HP-UX Distributed Print System Administration Guide (German) 
Managing Systems and Workgroups (German) 

Configuring HP-UX for Peripherals (German) 

Using HP-UX (German) 

HP Micro Focus COBOL Language Reference, Additional Topics 

HP Micro Focus COBOL User's Guide 

HP Micro Focus System Reference Vol. #L 

HP Micro Focus System Reference Vol. #2 

HP Micro Focus Language Reference Vol. #L 

HP Micro Focus Language Reference Vol. #2 

HP Micro Focus User's Guide 

HP Micro Focus Getting Started 

HP Micro Focus Compatibility Guide 

HP Micro Focus Error Messages 
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B 3190-90011 
B 3190-90018 
B 3190-90029 
B 3190-90037 
B 3190-90038 
B 3190-90039 
B 3190-90040 
B 3190-90046 
B 3190-90046 
B 3190-90047 
B 3190-90048 
B 3190-90049 
B 3190-90050 
B 3190-90052 
B 3393-90006 
B 3476-90017 
B 3782-90034 
B 3782-90073 
B 3782-90074 
B 3782-90076 
B 3782-90103 
B 3782-90176 
B 3782-90192 
B 3834-90008 
B 3906-90001 
B 3906-90002 
B 3906-90005 
B 3928-90001 
B 3936-90019 
B 5158-90001 
J 2120-62000 
J 2120-90031 
J 2157-90013 
J 2157-90014 
J 2163-90005 
J 2165-90012 
J 2165-90017 
J 2166-90008 
J 2399-90000 
J 2399-90001 
J 2496-90000 
J 2496-90012 
J 2655-90003 
J 2655-90007 
J 2655-90011 
J 2669-90005 
J 2669-90006 
J 2669-90007 
J 2669-90008 
J 2671-90008 
J 2671-90009 
J 2695-90002 
J 2793-90000 
J 2793-90034 
J 2805-90001 
J 2806-90021 


DCE Application Environment Specification 

Understanding DCE 

Guide to Writing DCE Applications 

OSF DCE Application Development Reference 

OSF DCE Application Development Guide, I 

OSF DCE Application Development Guide, II 

OSF DCE Application Development Guide, III 

I ntroduction to OSF DCE 

I ntroduction to OSF DCE 

OSF DCE Command Reference 

OSF DCE System Administration: Core Components 

OSF DCE DFS Administration Guide & Reference 

OSF DCE GDS Administration Guide & Reference 

Planning and Configuring FHP DCE 

Developer's Toolkit Release Notes for FIP-UX 10.30 

FI P PAK Performance Analysis User's Guide 

Moving FIP-UX 9.x Code and Scripts to 10.x (Analysis& Conversion) 

Upgrading from FIP-UX 9.x to 10.x 

Read Me Before I nstalling or Upgrading FIP-UX 10.10 

Read Me Before Preparing for Upgrade from FIP-UX 9.x to 10.x 

Read Me Before I nstalling or Updating FIP-UX 10.20 

Support Media User's Manual 

Read Me Before I nstalling or Updating FIP-UX 11.00 

FHP Process Resource Manager User's Guide 

HP-UX FORTRAN/9000 Programmer's Guide 

HP-UX FORTRAN/9000 Programmer's Reference 

HP-UX Floating-Point Guide 

HP OnlineJ FS Installation I nstructions 

Managing MC/ServiceGuard 

Configuring OPS Clusters with MC/LockManager 

Using the HP DTC Manager/UX 

HP DTC Manager/UX: Release Notes 

I nstalling and Administering FDDI 

FDDI/9000 Quick I nstallation Guide 

Release Notes: FTAM 9000 

Token Ring S700 10.0 Quick I nstallation 

EISA Token Ring Release Notes 

Token Ring S800 10.0 Quick I nstallation 

VT3K Quick Reference 

VT3K Customer Letter 

Using DTC 16RX 

DTC 16RX Release Notes 

EISA 100VG AnyLAN Quick Installation Guide 

I nstalling and Administering EISA/100VG AnyLAN 

100VG AnyLAN for Series 700 Release Notes 

LMU I nstallation & Administration 

LMU Troubleshooting and Commands 

LMU 1.x to 2.2 Migration 

Using LMU 2.2 

Netware v3.12 I nstallation and Administration 

Netware v3.12 Release Notes 

EISA 100VG AnyLan for Series 800 Release Notes 

X.25/9000 User's Guide 

X.25J 2793A Release Notes 

ATM Release Notes 

ATM Release Notes 


For information about the availability of any of these manuals in your local language, contact your sales 
center. 


For HP Micro Focus COBOL manuals, contact your HP sales representative and request the manuals-only 
option of the product. 
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Hewlett-Packard also recommends thefollowing retail books: 

Clusters for High Availability: A Primer of HP-UX Solutions, 

Prentice Hall (ISBN 0-13-494758-4) 

Disk and File Management Tasks on HP-UX, 

Prentice Hall (ISBN 0-13-518861-X) 

Go Solo: How to I mplement and Go Solo with the SingleU NIX Specification, 
Prentice Hall (ISBN 0-13-439381-3) 

A Guide to Netware for UNIX, 

Prentice Hall (ISBN 0-13-300716-2) 

HP-UX 10.X System Administration "How Tcf Book, 

Prentice Hall (ISBN 0-13-125873-7) 

Kornshell Programming Tutorial, 

Addison Wesley (ISBN 0-201-56324-X) 

Learning the HP-UX Operating System, 

Prentice Hal I (ISBN 0-13-258534-0) 

The New Kornshell Command and Programming Language, 

Prentice Hal I (ISBN 1-13-182700-6) 

Portable Shell Programming: An Extensive Collection of Bourne Shell Examples, 
Prentice Hall (ISBN 0-13-451494-7) 

Practical DCE Programming, 

Prentice Hal I (ISBN 0-13-324419-9) 

sendmail, 

O'Reilly & Associates (ISBN 1-56592-222-0) 

Thread Time: The MultiThreaded Programming Guide, 

Prentice Hal I (ISBN 0-13-190067-6) 

The UNIX C Shell Field Guide, 

Prentice Hall (ISBN 0-13-937468-X) 

Using& ManagingUUCP, 

O'Reilly & Associates (ISBN 1-56592-153-4) 

Using C-Kermit, 

Digital Press, Columbia University (ISBN 1-55558-164-1) 

Volume 3: X Window System User's Guide, Standard Edition, 

O'Reilly & Associates (ISBN 1-56592-014-7) 

Volume 3M: X WindowSystem User’sGuide, Motif Edition, 

O'Reilly & Associates (ISBN 1-56592-015-5) 

Writing Your Own OSF Motif Widgets, 

Prentice Hal I (ISBN 0-13-104191-6) 

Toorder the above retail books, call: 

Addison Wesley: 

1-800-822-6339 (from the U .S) 

1-800-447-2226x5190 (for international orders) 

Digital Press: 

212-854-3703 

O'Reilly and Associates, Inc.: 

1-800-998-9938 

Prentice Hall: 

1-800-947-7700 (from the U .S.) 

1-800-922-0579 (for government orders) 

201-767-4990(for international orders) 
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NAME 

math - math functions and constants 

SYNOPSIS 

#include <math.h> 

DESCRIPTION 

This file contains declarations of all the functions in the Math Library (described in Section (3M)). 

It also defines thefollowing constants that may be used in initializations or returned as error values: 

HUGE_VAL The maximum value (type double) of a double-precision floating-point number (IEEE 
positive INFINITY). 

NAN AquietNaN (Not-a-Number) value (type float). 

INFINITY A positive infinity value (type float). 

Thefollowing mathematical constants are defined for user convenience: 

M_E The base of natural logarithms (e). 

M_LOG2E The base-2 logarithm of e. 

M_LOG10E The base-10 logarithm of e. 

M_LN2 The natural logarithm of 2. 

M_LN10 The natural logarithm of 10. 

M_PI The ratio of the circumference of a circle to its diameter. (There are also several frac¬ 
tions of u, its reciprocal, and its square root: M_PI_2, M_PI_4, M_1_PI, M_2_PI, 
and M_2_SQRTPI). 

M_SQRT2 The positive square root of 2. 

M_SQRT1_2 

The positive square root of 1/2. 

For the definitions of various machine-dependent constants, see the description of the <values.h> 
header file. 

FILES 

/usr/include/math.h 

SEE ALSO 

intro(3), fenv(5), values(5). 

STANDARDS CONFORMANCE 

<math.h>: SVID3, XPG4.2, ANSI C 
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NAME 

mknod.h - header file of macros for handling device numbers 

SYNOPSIS 

#include <sys/mknod.h> 

DESCRIPTION 

The header file <sys/mknod.h> defines macros to create and interpret device identification numbers for 
use with themknod() system call (see mknod(2)). 

The use of these macros is architecture-dependent. See the System Administration Manual for your system 
for information on how to select major and minor device numbers. 

mknod.h contains the macro 

dev_t makedev(int major, int minor) 

which packs the major and minor components into a device identification number suitablefor the dev argu¬ 
ment of mknod () , and the two macros: 

int major(dev_t dev) 
int minor(dev_t dev) 

which extract the major and minor number components, respectively, from a device identification number, 
da/. 

The macro MlNOR_FORMAT is a printf () specification (see printf(3S)) that prints the minor number in 
the format best suited to the particular implementation; it is used by the long format of the Is command 
(see ls(D) to show the minor numbers for device files. 

The base of the number is indicated in the same way as in the C programming language: no leading zero 
for decimal, leading zero for octal, and leading Ox for hexadecimal. 

SEE ALSO 

ls(l), mknod(lM), mknod(2), printf(3S). 
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NAME 

mm - the M M macro package for formatting documents 

SYNOPSIS 

mm [options] [files] 
nroff -mm [options] [files] 

DESCRIPTION 

This package provides a formatting capability for a very wide variety of documents. The manner in which a 
document is typed in and edited is essentially independent of whether the document is to be eventually for¬ 
matted at a terminal or is to be phototypeset. See the references below for further details. The -mm 
option causes nroff (1) and troff to use the non-compacted version of the macro package. 

FILES 

/usr/share/lib/macros/mmn non-compacted version of the package 

/usr/shar^lib/tmac/tmac.m pointer to the non-compacted version of the package 


SEE ALSO 

mm(l), nroff(l). 

MM - Memorandum Macros tutorial in Ted Formatters User's Guide. 
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NAME 

mman - memory mapping definitions 

SYNOPSIS 

#include <sys/iranan.h> 

DESCRIPTION 

The <sys/mman .h > header defines the following symbolic constants for use with the madvise() func¬ 
tion: 


MADVJTORMAL 
MADV_RAND OM 
MADV_SEQUENTIAL 
MADV WILLNEED 
MADV_DONTNEED 
MADV_SPACEAVAIL 


No further special treatment. 
Expect random page references. 
Expect sequential page references. 
Will need these pages. 

Will not need these pages. 

Ensure that resources are reserved. 


The following symbolic constants are defined for use with the mmap () and mprotect() functions: 


PROT_READ 
PROTWRITE 
PROT EXEC 
PROT^NONE 


Region can be read. 

Region can be written. 
Region can be executed. 
Region cannot be accessed. 


The following symbolic constants are defined for use with the inmap() function: 


MAP_FILE 

MAP_ANONYMOUS 

MAP_VARIABLE 

MAP_FIXED 

MAP_SHARED 

MAP_PRIVATE 


Map a file. 

Map an unnamed memory region. 

Place region at implementation-computed address. 
Place region at specified address. 

Share changes made to mapped region. 

Changes to mapped region are private to a process. 


The following symbolic constants are defined for use with the msync() function: 


MSSYNC Perform synchronous writes. 

MS ASYNC Perform asynchronous writes. 

MS_INVALIDATE I nvalidate cached pages. 


The following symbolic constants are defined for use with the msem_init() , msem_lock() , and 
msem_unlock() functions: 


MSEM_LOCKED 
MSEM_UNLOCKED 
MSEM IFNOWAIT 
MSEM_IF_WAITERS 


Create semaphore in locked state. 

Create semaphore in unlocked state. 

Do not wait if semaphore is locked. 

Do not unlock if semaphore has no waiters. 


The typedef struct msemaphore is defined for use with the msem_init () , msem_lock() , 
msem_unlock () , and msem_remove() functions. 


SEE ALSO 

mmap(2), munmap(2), mprotect(2), msync(2), madvise(2), msemjnit(2), msem_remove(2), msem_lock(2), 
msem_unlock(2). 
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NAME 

ndir.h - format of HP-UX directory streams 

SYNOPSIS 

include <ndir.h> 

DESCRIPTION 

This header file defines data types used by the directory stream routines described in directory(3C). It is 
provided to allow older hp-ux programs to compile unmodified. This file is obsoleted starting from HP-UX 
10.30 and is going to be removed in future releases. The header file <dirent.h> described on dirent(5) 
should be used in all new programs for compatibility with System V Release 3, the X/Open Portability 
Guide, and theiEEE P1003.1 posix standard. 

The foil owing data types are defined: 

dir A structure containing information about an open directory stream. 

struct direct A structure defining theformat of entries returned by the old hp-ux readdir function 
(see di rectory (3C)). 

The struct direct structure includes the foil owing members: 

char d name[MAXNAMLEN+1]; /* name of directory entry */ 

long d ino; /* file serial number */ 

short d namlen; /* length of string in d name */ 

short d reclen; /* length of this record */ 

The constant maxnamlen is defined in <ndir.h>. 

This file also contains external declarations for the functions in the di rectory (3C) package, including the fol¬ 
lowing declaration: 

extern struct direct *readdir(); 

WARNINGS 

lint(l) might complain about programs that include this fil e, although they compileand run correctly. 

AUTHOR 

ndir.h was developed by the University of California, Berkeley, and HP. 

SEE ALSO 

directory(3C), dirent(5). 
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NAME 

nlio- NativeLanguagei/O (nlio) Subsystem 

DESCRIPTION 

The hp-ux Native Language I/O (nlio) Subsystem is a set of servers, filters, utilities and libraries that pro¬ 
vide means to efficiently input and output multi byte characters on multi byte terminals, printers and the X 
Wi ndow System. 

nlio provides application-transparent multi byte code conversion between the internal code and the exter¬ 
nal code. Application programs including hp-ux commands can utilize thefeature of the multibyte charac¬ 
ter I/O over multibyte terminals, printers and the X Window System without modifying the I/O portion of 
the program code or linking any special I/O library. 

The supported languages arej apanese, Korean, Simplified Chineseand Traditional Chinese. 
nlio supports the foil owing functionalities: 

• Read and write multibyte characters on HP Asian terminals and theX Window System. 

• Print multibyte characters with HP Asian or HP LaserJ et printers. 

• Allow hp-ux commands, such as cat(l), more(l), and vi (1), to use multibytecharacters. 

• Create and modify user-defined characters. 

• Support multibytecharacters for theStarbaseGraphics Library. 

• Provide language-specific popular input methods. 

• Support code conversion utilities and libraries. 

• Create and modify user-defined dictionaries for J apanese and Korean. 

• Read and writej apanese multibyte characters on a bitmap display. 

• Writej apanese multibyte characters on a bitmap display with theFAFM libraries. 

• Providea set of librariesfor J apaneseKana-to-Kanji conversion. 

AUTHOR 

nlio was developed by HP. 

SEE ALSO 

NativeLanguagel/O manuals 
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NAME 

pamunix- authentication, account, session, and password management PAM modules for UNIX 

SYNOPSIS 

/usr/lib/security/libpam_unix.1 

DESCRIPTION 

The UNIX service module for PAM, /usr/lib/security/libpam_unix. 1, provides functionality 
for all four PAM modules: authentication, account management, session management and password 
management. 

The libpam_unix. 1 module is a shared object that can be dynamically loaded to provide the necessary 
functionality upon demand. Its path is specified in the PAM configuration file. 

Unix Authentication Module 

The UNIX authentication component provides functions to verify the identity of a user, 
(pam_sm_authenticate ()) and to set user specific credentials (parn_sm_setcred ()). 

pam_sm_authenticate () compares the user entered password (or password retrieved from the user's 
smart card) with the password from UNIX password database, including the protected password database 
for trusted systems. If the passwords match, the user is authenticated. If the user also has secure RPC 
credentials and the secure RPC password is the same as the UNIX password, then the secure RPC creden¬ 
tials are also obtained. 

The following options may be passed to the UNIX service module: 
debug syslog(3C) debugging information at LOG DEBUG level, 

nowarn Turn off warning messages. 

use_first_pass 

It compares the password in the password database with the user's initial password 
(entered when the user authenticated to the first authentication module in the stack). If 
the passwords do not match, or if no password has been entered, quit and do not prompt 
the user for a password. This option should only be used if the authentication service is 
designated as optional in thepam. conf configuration file. 

try_first_pass 

It compares the password in the password database with the user's initial password 
(entered when the user authenticated to the first authentication module in the stack). If 
the passwords do not match, or if no password has been entered, prompt the user for a 
password. 

use_psd psd stands for personal security device, for the current implementation there is only one 

security device: the smart card. It compares the password in the password database 
with the password stored on the user's smart card. With this option the PAM Frame¬ 
work prompt "Enter PIN:" is used instead of the password prompt. This option is only 
supported with the authentication or password module types (auth, password) services 
in thepam. conf or in thepam_user . conf configuration files. 

When prompting for the current password, the UNIX authentication module will use the prompt, "Pass¬ 
word:" unless one of the following scenarios occur: 

1. The option try_first_pass is specified and the password entered for the first module in the 
stack fails for the UNIX module. 

2. The option try_first_pass is not specified, and the earlier authentication modules listed in 
thepam. conf file have prompted the user for the password. 

3. The option use_psd is specified. In this case, the UNIX authentication module will use the 
prompt "Enter PI N:". 

In cases 1 and 2, the UNIX authentication module will use the prompt "System Password:". 

Thepam_sm_setcred () function sets user specific credentials. If the user had secure RPC credentials, 
but the secure RPC password was not the same as the UNIX password, then a warning message is printed. 
If the user wants to get secure RPC credentials, then keylogin(l) needs to be run. 
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Unix Account Management Module 

The UNIX account management component provides a function to perform account management 
(pam_sm_acct_mgmt ()). The function retrieves the user's password entry from the UNIX password 
database and verifies that the user's account and password have not expired. For trusted systems, this 
module also validates the allowed access time and access terminal based upon the security configuration. 
The following options may be passed in to the UNIX service module: 

debug syslog(3C) debugging information at LOGDEBUG level, 

nowarn Turn off warning messages. 

Unix Session Management Module 

The UNIX session management component provides functions to initiate (pam_sm_open_session ()) 
and terminate (pam_srn_close_session ()) UNIX sessions. For UNIX, pam_open_session () 
updates the last successful or unsuccessful login time in the protected password databasefor trusted mode. 
The account management module reads the information to display the previous time the user logged in. 
The following options may be passed in to the UNIX service module: 

debug syslog(3C) debugging information at LOG DEBUG level, 

nowarn Turn off warning messages. 

pam_close_session is a NULL function. 

Unix Password Management Module 

The UNIX password management component provides a function to change passwords 
(pam_sm_chauthtok ()) in the UNIX password database. This module must be required in 
pam. conf . It can not be optional or sufficient . The following options may be passed in to the 
UNIX service module: 

debug syslog(3C) debugging information at LOG DEBUG level. 

nowarn Turn off warning messages. 

use_first_pass 

It compares the password in the password database with the user's old password 
(entered to the first password module in the stack). If the passwords do not match, or if 
no password has been entered, quit and do not prompt the user for the old password. It 
also attempts to use the new password (entered to the first password module in the 
stack) as the new password for this module. If the new password fails, quit and do not 
prompt the user for a new password. 

try_first_pass 

It compares the password in the password database with the user's old password 
(entered to the first password module in the stack). If the passwords do not match, or if 
no password has been entered, prompt the user for the old password. It also attempts 
to use the new password (entered to the first password module in the stack) as the new 
password for this module. If the new password fails, prompt the user for a new pass¬ 
word. 

use_psd It prompts the user for the PIN (with the PIN, the PAM Framework can retrieve a pass¬ 

word from the smart card) and the old password is retrieved from the smart card. It 
compares the password in the password database with the user's old password. If the 
passwords match, it prompts the user for a new password. 

If the user's password has expired, the UNIX account module saves this information in the authentication 
handle using pam__set_data () . The UNIX password module retrieves this information from the 
authentication handle using pam_get_data () to determine whether or not to force the user to update 
their password. 

SEE ALSO 

keylogin(l), pam(3), pam_authenticate(3), pam_setcred(3), syslog(3C), pam.conf(4), pam_user.conf(4). 
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NAME 

pam_updbe- user policy definition service module 

SYNOPSIS 

/usr/lib/security/libpam_updbe.1 

DESCRIPTION 

The user policy definition service module for PAM, /usr/lib/security/libpam_updbe . 1, reads 
options defined in the user configuration file, /etc/pam_user. conf (see pam_user.conf(4)) and uses 
pam_set_data (see pam_set_data(3)) to store the information in the pam handlefor subsequent service 
modules to use. Service modules perform pam_get_data to retrieve corresponding information from the 
pam handlewhen the user is authenticated, or when the user password is changed. 

The use of pam_updbe is not mandatory. It is needed only when per user configuration is used. However, 
in order for the functionality of pam_updbe to take effect, it must be listed as the first service module in 
/etc/pam.conf. 

Like any other service module, pam_updbe provides interfaces for all four PAM modules: authentication, 
account management, session management and password management. Each modulejust reads the options 
defined for the specific module type. 

UPDBE Authentication Module 

TheUPDBE authentication component provides functions to read options defined in pam_user. conf for 
the moduletype "auth". The module data name used is PAM_AUTH_USER. 

Unix Account Management Module 

The UNIX account management component provides a function to read options defined in 

pam_user. conf for the module type "account". The module data name used is PAM_ACCOUNT_USER. 

Unix Session Management Module 

The UNIX session management component provides a function to read options defined in 

pam_user. conf for the module type "session". The module data name used is PAM_SESSION_USER. 

Unix Password Management Module 

The UNIX password management component provides a function to read options defined in 

pam_user. conf for the module type "password". The module data name used is 

PAM PASSWORDUSER. 

SEE ALSO 

pam(3), pam_set_data(3), pam.conf(4), pam_user.conf(4). 
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NAME 

pd_att - index of HPDPS attribute manpages 

DESCRIPTION 

To view the file that contains information about the valid attributes for a given object, enter the following 
command: 

man name_of_file 

where name_of_fileis one of the following: 

pd_att_document 

pd_at t_ivdo cument 

pd_att_iv j ob 

pd_att_job 

pd_att_log 

pd_att_queue 

pd_att_log_ptr 

pd_at t_phy_pt r 

pd_att_spooler 

pd_att_supervisor 
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NAME 

pd_att_d(xumerit - list of attributes for an HPDPS document object 

DESCRIPTION 

The following is a list of valid attributes and values for the document object class of the HP Distributed 
Print Service. 


Attributes for a Document Object 


Settable Attribute Listing 



bottom-margin 

content-orientation 

copy-count 

default-character-set 

default-font 

default-input-tray 

default-medium 

default-printer-resolution 

document-comment 

document-format 

input-tray-select 

left-margin 

number-up 

page-count 

page-select 

plex 

printer-pass-through 

right-margin 

sides 

top-margin 


Specifiable Attribute Listing 


document-file-name 
document-type 
initial-value-document 
transfer-method 


Table 1-1. Document Attributes 


Attribute 


Explanation 


Value Type 


Usage 

Guidelines 


Description 


beginning-page-requested 


Non Settable. 


Identifies the beginning page of the document specified 
by the beginning-page component of the document page- 
select attribute. 


Single Value. 


An integer from 1 to 2147483647. Implicitly set by HPDPS. 


No default 


This attribute is intended for use in the ipmap file 
to convert the beginning-page component of the 
page-select attribute to the interface program option. 
Use the page-select attribute to specify the starting 
page to print with the pdpr command. 
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Attribute 

| Description 



Name 

| bottom-margin 



Input 

Synonym 

| bm 



Type 

| Settable with the pdpr, pdset, or 

pdmod commands. 


1 

Usage | 

Explanation 

i 

| Specifies the distance between the bottom edge of 
| logical page and the bottom edge of the text area 
| held in the reading orientation. The values are 
| of characters. 

the 

when 

Ln units 

Value Type 

i 

| Single value. 



Values 

| An integer from 1 to 2147483647. 



Default 

| No default. 



i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 



Name 

| content-orientation 



Input 

Synonym 

| orientation 



Type 

| Settable with the pdpr, pdset, or 

pdmod commands. 


Usage 

| Values vary by printer model. 



Explanation 

i 

| Identifies the page presentation (how the data is 
| placed on a page) for the document. 

to be 

Value Type 

i 

| Single value. 



Values 

| One of the following fixed values 




| landscape 
| portrait 
| reverse-portrait 
| reverse-landscape 



Default 

| portrait 



Usage 

Guidelines 

i 

| o The document is validated and scheduled against the 

| printer attribute content-orientations-supported. 

i 

Attribute 

i 

| Description 



Name 

| copy-count 



Input 

Synonym 

| copies 
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Type 

Settable with the pdpr, pdset, or pdmod 

commands. 

1 

Usage | 

Explanation 

Specifies the number of document copies 
job copy. 

to be printed per 

Value Type 

Single value. 


Values 

An integer from 1 to 2147483647. 


Default 

i 


Usage 

Guidelines 

o The document is validated and scheduled against the 

printer attribute maximum-copies-supported. 
o A value of zero (0) is an error. 

i 

Attribute 

Description 


Name 

default-character-set 


Type 

Settable with the pdpr, pdset, or pdmod 

commands. 

Usage 

Values vary by printer model. 


Explanation 

Identifies the default character set to 

be used. 

Value Type 

Single value. 


Values 

One of the following fixed values: 



iso-ucs-2-level2 

other 

ascii 

iso-latinl 

iso-latin2 

iso-latin3 

iso-latin4 

iso-latin-cyrillic 

iso-latin-arabic 

iso-latin-greek 

iso-latin-hebrew 

iso-latin5 

iso-latin6 

iso-text-communication 
half-width-katakana 
jis-encoding 
shift-jis 

euc-packed-format-japanese 

euc-fixed-width-japanese 

iso-reg4-united-kingdom 

iso-regll-swedish-for-names 

iso-regl5-italian 

iso-regl7-spanish 

iso-reg21-german 

iso-reg60-danish-norwegian 

iso-reg69-french 

Unicode 

ucs4 

unicode-ascii 

unicode-latinl 
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unicode-ibm-2039 
unicode-ibm-1261 
Unicode-ibm-1268 
unicode-ibm-1276 
unicode-ibm-12 64 
unicode-ibm-12 65 
windows30-latinl 
windows31-latinl 
windows31-latin2 
windows31-latin5 
hp-roman8 

adobe-standard-encoding 

ventura-us 

ventura-international 

dec-mcs 

pc-page-850-multilingual 

pc-page-852-latin2 

pc8-page-437-us 

pc8-danish-norwegian 

pc-page-862-latin-hebrew 

pc8-turkish 

ibm-symbols 

ibm-thai 

hp-legal 

hp-pifont 

hp-math8 

hp-ps-math 

hp-desktop 

ventura-math 

microsoft-publishing 

windows31j 

gb-2312 

big5 

cns 

ksc-5601 

cede 


Default 


No default. 


Usage | o The document is validated and scheduled against the 

Guidelines | printer attribute character-sets-supported. 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


default-font 


Settable with the pdpr, pdset, or pdmod commands. 


Values vary by printer model. 


Identifies the default font to be used. 


Single value. 


A text string up to 4095 characters that contains the 
font name. 


No default. 


o The document is validated and scheduled against the 
printer attribute fonts-supported. 
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Attribute 

Description 

Name 

default-input-tray 

Type 

Settable with the pdpr, pdset, or pdmod commands. 

Usage 

Values vary by printer model. 

Explanation 

Identifies an input-tray on the printer that contains the 
medium that is to be used for normal document pages. 

Value Type 

Single value. 

Values 

A text string of up to 255 characters that describes the 
input tray, or one of the following fixed values: 


top 

middle 

bottom 

envelope 

manual 

large-capacity 

main 

side 

Default 

No default. 

Usage 

Guidelines 

o The document is validated and scheduled against the 

printer attribute input-trays-supported. 
o The following attributes may be used to select the 

input tray. If more than one of these attributes are 
supplied then the attribute with the highest 
precedence, as numbered, is chosen: 


1. input-tray-select 

2. default-medium 

3. default-input-tray 

i 

Attribute 

Description 

Name 

default-medium 

Type 

Settable with the pdpr, pdset, or pdmod commands. 

Usage 

Values vary by printer model. 

Explanation 

Identifies the medium for normal document pages on which 
this document is to be printed. 

Value Type 

Single value. 

Values 

One of the following fixed values or a text string that 
contains the name of the medium. The text string can be 
up to 255 characters long per medium. 


iso-a4-white 

iso-a4-colored 

iso-a4-transparent 

iso-a3-white 
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1 

iso-a3-colored 



1 

iso-a5-white 



1 

iso-a5-colored 



1 

iso-b4-white 



1 

iso-b4-colored 



1 

iso-b5-white 



1 

iso-b5-colored 



1 

na-letter-white 



1 

na-letter-colored 



1 

na-letter-transparent 



1 

na-legal-white 



1 

na-legal-colored 



1 

iso-b5-envelope 



1 

iso-b4-envelope 



1 

iso-c4-envelope 



1 

iso-c5-envelope 



1 

designated-long-envelope 



1 

na-10xl3-envelope 



1 

na-9xl2-envelope 



1 

monarch-envelope 



1 

na-number-10-envelope 



1 

na-7x9-envelope 



1 

na-9x11-envelope 



1 

na-10xl4-envelope 



1 

na-number-9-envelope 



1 

na-6x9-envelope 



1 

na-10xl5-envelope 



1 

jis-b4-white 



1 

jis-b4-colored 



1 

jis-b5-white 



1 

jis-b5-colored 



1 

executive 



1 

folio 



1 

invoice 



1 

ledger 



1 

quarto 



1 

iso-aO-white 



1 

iso-al-white 



1 

iso-a2-white 



1 

iso-a6-white 



1 

iso-a7-white 



1 

iso-a8-white 



1 

iso-a9-white 



1 

iso-al0-white 



1 

iso-bl0-white 



1 

iso-bO-white 



1 

iso-bl-white 



1 

iso-b2-white 



1 

iso-b3-white 



1 

iso-b6-white 



1 

iso-b7-white 



1 

iso-b8-white 



1 

iso-b9-white 



1 

iso-bl0-white 



1 

jis-bO-white 



1 

jis-bl-white 



1 

jis-b2-white 



1 

jis-b3-white 



1 

jis-b6-white 



1 

jis-b7-white 



1 

jis-b8-white 



1 

jis-b9-white 
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jis-bl0-white 

a 

b 

c 

d 

e 


Default 


No default. 


Usage 

Guidelines 


o The document is validated against the 

logical printer attribute media-supported and the 
physical printer attribute media-supported 
o The document is scheduled against the 

physical printer attributes media-supported and 
media-ready 

o The following attributes may be used to select the 

input tray. If more than one of these attributes are 
supplied then the attribute with the highest 
precedence, as numbered, is chosen: 


1. input-tray-select 

2. default-medium 

3. default-input-tray 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Values 


Description 


default-printer-resolution 


Settable with the pdpr, pdset, or pdmod commands. 


Values vary by printer model. 


Identifies the default printer resolution to be used. 


Single Value. 


One of the following fixed values or an integer from 1 to 


2147483647. 


highest 

lowest 

middle 


Default 


No default. 


Usage | o The value of this attribute is validated against the 

Guidelines | printer attribute printer-resolutions-supported. 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Description 


document-comment 


Settable with the pdpr, pdset, or pdmod commands. 


Provides information that is associated with this 
document. 


Single value. 
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Values 

| A text string up to 4095 characters that contains 
| information about this document such as the fonts to be 
| used. 

Default 

| No default. 

i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 

Name 

| document-file-name 

Input 

Synonym 

| file-name 

Type 

| Specifiable 

1 

Usage | 

Explanation 

i 

| Specifies the file name or other source that provided the 
| data for the document to be or was printed. 

Value Type 

| Single value. 

Values 

| A text string up to 4095 characters that contains the 
| global ID. 

Default 

| No default. 

Usage 

Guidelines 

| o Set by HPDPS from the name of the file or source 

| specified with the pdpr command. 

i 

Attribute 

i 

| Description 

Name 

| document-format 

Input 

Synonym 

| format 

Type 

| Settable with the pdpr, pdset, or pdmod commands. 

Usage 

| Values vary by printer model. 

Explanation 

| Identifies the format (datatype) of the document. 

Value Type 

| Single value. 

Values 

| One of the following fixed values: 


| Fixed Value Input Synonym 

| ascii 

| pci hppcl 

1 hp-pcl 

| hpgl hp-gl 

i pji 

| postscript ps 

| ipds 

1 ppds 
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escapep 

epson 

ddif 

interpress 

iso-6429 

line-data 

modca 

regis 

scs 

spdl 

tek4014 

pds 

igp 

codev 

dsc-dse 

wps 

ln03 

ccitt 

quic 

cpap 

dec-ppl 

simple-text 

npap 

doc 

impress 

pinwriter 

npdl 

nec201pl 

automatic 

pages 

lips 

tiff 

diagnostic 

capsl 

excl 

lcds 

xes 

passthru 


Default 


ascii 


Usage | o The document is validated and scheduled against the 

Guidelines | printer attribute document-formats-supported. 


Attribute 

| Description 

Name 

| document-sequence-number 

Input 

| sequence-number, document-number 

Synonym 

i 

Type 

| Not Settable 


Usage 


Explanation! Specifies the document number in relation to the other 
| documents of a multiple document job. HPDPS sets this 
| value. 


Value Type 


Single value. 
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Values 


Default 


Usage 

Guidelines 


One of the integers from 1 to 2147483647. 


No default. 


o Used to identify this document in request status or 
when HPDPS provides event status. 


Attribute 


Name 


Input 

Synonym 


Type 


Usage 


Explanation 


Value Type 


Values 


Description 


document-type 


type 


Specifiable using the pdpr command. 


Values vary by printer model. 


Indicates that the document is either a printable 
document, a font, or some other resource. 


Single value. 


One of the following fixed values: 


file-reference 

printable 


Default 


printable 


Usage | o The document is validated and scheduled against the 

Guidelines | printer attribute document-types-supported. 


Attribute 


Name 


Type 


Usage 


Explanation 


Description 


ending-page-requested 


Non Settable. 


Identifies the ending page of the document specified 
by the ending-page component of the document page-select 
attribute. 


Value Type 


Values 


Default 


Single Value. 


An integer from 1 to 2147483647. 


No default 


Implicitly set by HPDPS. 


Usage | o This attribute is intended for use in the ipmap 

Guidelines | file to convert the ending-page component of the 

| page-select attribute to the interface program option. 

| Use the page-select attribute to specify the ending 

| page to print with the pdpr command. 


Attribute 


Description 


HP-UX Release 11.0: October 1997 


-10- 


Section 5-97 































pdattdocu merit (5) 


pdattdocu merit (5) 


Name 


initial-value-document 


Type 


Usage 


Specifiable with the pdpr command. 


Explanation 


Identifies an initial-value-document object (within a 
given spooler) that is to be used for this document. 

This object may be used when a document is created during 
j ob submis sion. 


Value Type 


Single value. 


Values 


Any text string up to 255 characters that contains the 
name of this initial-value-document. 


Default 


No default 


Usage 

Guidelines 


o If this attribute is specified, the document uses the 
attribute values from the initial-value-document 
object to set the document attribute values, unless 
initial-value-document attribute values are 
overridden by attribute values supplied at the 
command line. 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Values 


Description 


input-tray-select 


Settable with the pdpr, pdset, or pdmod commands. 


Values vary by printer model. 


Identifies which input tray (bin) contains the medium 
that is to be used for this document. 


Single value. 


A text string of up to 255 characters that describes the 
input tray, or one of the following fixed values: 


top 

middle 

bottom 

envelope 

manual 

large-capacity 

main 

side 


Default 


No default 


Usage 

Guidelines 


o The document is validated and scheduled against the 
printer attribute input-trays-supported. 


o The following attributes may be used to select the 

input tray. If more than one of these attributes are 
supplied then the attribute with the highest 
precedence, as numbered, is chosen: 


1. input-tray-select 
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2. default-medium 

3. default-input-tray 


Attribute 


Name 


Input 

Synonym 


Type 


Usage 


Description 


left-margin 


lm 


Settable with the pdpr, pdset, or pdmod commands. 


Explanation 


Specifies the distance between the left edge of the 
logical page and the left edge of the text area when 
held in the reading orientation. The values are in units 
of characters. 


Value Type 


Values 


Default 


Single value. 


An integer from 1 to 2147483647. 


No default. 


Usage 

Guidelines 


Attribute 


Name 


Type 


Usage 


Explanation 


Description 


number-up 


Settable with the pdpr, pdset, or pdmod commands. 


Values vary by printer model. 


Specifies the number of source page-images to impose upon 
a single instance of a selected medium, that is, the 
number of source pages to appear on a single printed page. 


The possible values are: 


0 Suppress any number-up operation or embellishment. 

1 1 source page per physical page. 

2 2 source pages per physical page. 

4 4 source pages per physical page. 


Value 


Values 


Type 


Single value. 


One of the following fixed values: 


0 

1 

2 

4 


Default 


No default. 


Usage 

Guidelines 
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Attribute 

Description 

Name 

object-class 

Type 

Non Settable 

1 

Usage | 

Explanation 

Identifies the object class to which this object belongs. 

Value Type 

Single value. 

Values 

The value of this attribute is document. 

Default 

document 

i 

Usage | 

Guidelines | 

1 

Attribute 

Description 

Name 

octet-count 

Type 

Non Settable 

1 

Usage | 

Explanation 

Specifies the document size in octets (bytes). Computed 
by HPDPS when this document object is created. 

Value Type 

Single value. 

Values 

An integer from 0 to 9223372036854775800. 

Default 

N/A 

Usage 

Guidelines 

o Used to compute total octet count for a job and to 

provide information about this document. 

i 

Attribute 

Description 

Name 

page-count 

Type 

Settable with the pdpr, pdset, or pdmod commands. 

Usage 

Specifies the estimated length of the job in pages. 

Explanation 

HPDPS determines the size of a job based on the total 
number of octets (bytes) in the job. For operator job 
management purposes, you may find that job size based on 
pages is easier. 

Value Type 

Single value. 

Values 

An integer from 0 to 2147483647. 

Default 

No default. 
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Usage 

Guidelines 

| Because HPDPS does not estimate job size in pages or use 
| the page-count value you specify, the value for the 
| page-count attribute should closely represent the actual 
| number of pages in the job if the operator is to make 
| valid decisions based on page count. 

i 

i 

i 

i 

i 

i i 

Attribute 

| Description 

i 

Name 

page-select 


Type 

Settable with the pdpr, pdset, or pdmod commands. 


Usage 

| Support for this attribute varies by printer model. The 
| value syntax also varies by printer model. 


Explanation 

| Specifies the range of pages to be printed. 


Value Type 

| Multiple values, however, only the first value is 
currently used. 


Values 

This is a complex attribute which has the following 
| components: 



| 1. beginning-page (an integer page number) 

| 2. ending-page (an integer page number) 


Syntax 

| -x "page-select=beginning-page:ending-page" 



| For example: -x "page-select=10:30" prints only pages 
| 10 through 30. 


Default 

| No default. 

1 

Usage 

Guidelines 

| o The document is validated against the printer 

| attribute page-select-supported. 

| o Only a numeric value is supported for this attribute. 

| o Only one page range may be specified. 


Component 

Description 


beginning- 

page 

An integer from 1 to 2147483647. 


ending- 

page 

| An integer from 1 to 2147483647. 


i i 

Attribute 

| Description 

i 

1 

Name 

| plex 

i 

Type 

| Settable with the pdpr, pdset, or pdmod commands. 

i 

Usage 

Values vary by printer model. 

i 

Explanation 

| Indicates whether the page images of this document are 
| conditioned for one-sided or two-sided printing and the 
| relative orientation of consecutive pages. 

i 

i 

i 

Value Type 

| Single value. 

i 
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One of the following fixed values: 

simplex (single sided) 

duplex (double sided) 

tumble (double sided, every other page upside-down) 


simplex 


| Usage | o This document is validated and scheduled against the 

| Guidelines | printer attribute plexes-supported. 

| | o HPDPS defaults "sides=2 M when plex=duplex. HPDPS does 

| | not currently perform any other conditioning when 

| | plex=duplex. 


Attribute | Description 


| Name 


| printer-initial-value-document 


Non Settable 


Explanation 


Value Type 


Attribute 


Explanation 


Value Type 


Usage 

Guidelines 


Attribute 


Explanation 


HPDPS sets this value to the name of the 
initial-value-document object used. 


Single value. 


No default. 


Description 


printer-pass-through 



Settable with the pdpr, pdset, or pdmod commands. 


Allows specific printer information to be submitted along 
with the document. 


Single value. 


A text string up to 4095 characters that contains options 
passed directly to the interface program. 


No default. 


o The value of this attribute is passed as the 4th 
argument of the printer interface program. 


Description 


right-margin 


Settable with the pdpr, pdset, or pdmod commands. 


Specifies the distance between the right edge of the 
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logical page and the right edge of the text area when 
held in the reading orientation. The values are in units 
of characters. 


Value Type 


Values 


Default 


Usage 

Guidelines 


Single value. 


An integer from 1 to 2147483647. 


No default. 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Values 


Default 


Description 


sides 


Settable with the pdpr, pdset, or pdmod commands. 


Specifies the number of media sides on which the document 
is to be printed. 


Single value. 


An integer of 1 or 2. 


1 


Usage | o This document is validated and scheduled against the 

Guidelines | printer attribute sides-supported. 


Attribute 


Name 


Input 

Synonym 


Type 


Usage 


Description 


top-margin 


tm 


Settable with the pdpr, pdset, or pdmod commands. 


Explanation 


Specifies the distance between the bottom edge of the 
logical page and the bottom edge of the text area when 
held in the reading orientation. The values are in units 
of characters. 


Value Type 


Values 


Default 


Single value. 


An integer from 1 to 2147483647. 


No default. 


Usage 

Guidelines 


Attribute 


Description 
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Name 

transfer-method 


Type 

Specifiable with the pdpr command. 


1 

Usage | 

Explanation 

Identifies the method by which the 

document is 


transferred to, or acquired by, the 

print server. 

Value Type 

Single value. 


Values 

One of the following fixed values: 



dce-pipe-pull 



with-request 


Default 

dce-pipe-pull 


Usage 

o This document is validated and 

scheduled against the 

Guidelines 

supervisor attribute transfer-methods-supported. 
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NAME 

pd_att_ivdocument - list of attri butes for an HPDPS initial value document object 

DESCRIPTION 

The following is a list of valid attributes and values for the initial value document object class of the HP 
Distributed Print Service. 

I nitial-value-document objects are used to set default values for document attributes. 

The initial-value-document object containstwo types of attributes: 

1. Those that either describe or are used by the initial-value-document object itself. 

2. Those used for defaultingvaluesfor document attributes. 


Attributes for an Initial Value Document Object 


1 

Settable Attribute Listing 

| Specifiable Attribute Listing 



bottom-margin 

| There are no specifiable 



content-orientation 

| attributes for a 



copy-count 

| initial-value-document object. 



default-character-set 

i 



default-font 

i 



default-input-tray 

i 



default-medium 

i 



default-printer-resolution 

i 



descriptor 

i 



do cume nt - c omme nt 

i 



document-format 

i 



document-type 

i 



input-tray-select 

i 



left-margin 

i 



list-of-managers 

i 



number-up 

i 



message 

i 



page-select 

i 



plex 

i 



printer-pass-through 

i 



right-margin 

i 



sides 

i 



top-margin 

i 



Note: In the following table, the attributes listed are used to set or 

used as defaults for the document unless otherwise specified. 


Table 1-1. 

Initial Value Document Attributes 

Attribute 

Description 

Name 

associated-server 

Type 

Non Settable 

1 

Usage | 

Explanation 

Indicates the name of the spooler in which this 
initial-value-document object resides. 

Value Type 

Single value. 

Values 

A text string up to 255 characters that contains the name 
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of the server. Set by HPDPS to the ServerName: portion of 



| the argument when this initial-value-document was 

created. 

Default 

| No default. 


Usage 

Guidelines 

| o This attribute is used by the initial-value-document 

| object. 

| o Value was set to the ServerName specified in the 

| pdcreate command when this initial-value object was 

created. 

i 

Attribute 

| Description 


Name 

bottom-margin 


Input 

Synonym 

| bm 


Type 

Settable with the pdpr, pdset, or pdmod commands. 


1 

Usage | 

Explanation 

| Specifies the distance between the bottom edge of 
| logical page and the bottom edge of the text area 
| held in the reading orientation. The values are 
| of characters. 

the 

when 

in units 

Value Type 

| Single value. 


Values 

| An integer from 1 to 2147483647. 


Default 

| No default. 


i 

Usage | 

Guidelines | 

1 

Attribute 

| Description 


Name 

| content-orientation 


Input 

| orientation 


Type 

| Settable with the pdcreate or pdset command. 


1 

Usage | 

Explanation 

Identifies the page presentation (how the data is 
placed on a page) for the document. 

to be 

Value Type 

| Single value. 


Values 

| One of the following fixed values: 



| landscape 
| portrait 
| reverse-portrait 
| reverse-landscape 


Default 

| No default. 
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Usage | o The document is validated and scheduled against the 

Guidelines | printer attribute content-orientations-supported. 


Attribute 


Name 


Input 

Synonym 


Type 


Usage 


Explanation 


Value Type 


Values 


Default 


Description 


copy-count 


copies 


Settable with the pdcreate or pdset command. 


Specifies the number of document copies to be printed per 
job copy. 


Single value. 


An integer from 1 to 2147483647 


No default. 


Usage | o A value of zero (0) is an error. 

Guidelines | o The document is validated and scheduled against the 

| printer attribute maximum-copies-supported. 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Values 


Description 


default-character-set 


Settable with the pdpr, pdset, or pdmod commands. 


Values vary by printer model 


Identifies a coded character-set that the server shall 
use as the coded character-set default for the pages of 
the document that require a coded character set 
specification. 


Single value. 


One of the following fixed values: 


iso-ucs-2-level2 

other 

ascii 

iso-latinl 

iso-latin2 

iso-latin3 

iso-latin4 

iso-latin-cyrillic 

iso-latin-arabic 

iso-latin-greek 

iso-latin-hebrew 

iso-latin5 

iso-latin6 

iso-text-communication 

half-width-katakana 

jis-encoding 
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shift-jis 

euc-packed-format-japanese 

euc-fixed-width-japanese 

iso-reg4-united-kingdom 

iso-regll-swedish-for-names 

iso-regl5-italian 

iso-reg!7-spanish 

iso-reg21-german 

iso-reg60-danish-norwegian 

iso-reg69-french 

Unicode 

ucs4 

unicode-ascii 
unicode-latinl 
unicode-ibm-2 039 
unicode-ibm-12 61 
Unicode-ibm-1268 
unicode-ibm-1276 
unicode-ibm-12 64 
unicode-ibm-1265 
windows30-latinl 
windows31-latinl 
windows31-latin2 
windows31-latin5 
hp-roman8 

adobe-standard-encoding 

ventura-us 

ventura-international 

dec-mcs 

pc-page-850-multilingual 

pc-page-852-latin2 

pc8-page-437-us 

pc8-danish-norwegian 

pc-page-862-latin-hebrew 

pc8-turkish 

ibm-symbols 

ibm-thai 

hp-legal 

hp-pifont 

hp-math8 

hp-ps-math 

hp-desktop 

ventura-math 

microsoft-publishing 

windows31j 

gb-2312 

big5 

cns 

ksc-5601 

cede 


1 

| Default 

I 

| No default. 

i 

1 

1 

| Usage 

1 

| o The document is validated and scheduled against the 

1 

1 

| Guidelines 

| printer attribute character-sets-supported. 

i 

i i i 

i 

| Attribute 

i 

| Description 

i 

1 

1 

| Name 

1 

| default-font 

1 

1 


Type 


Settable with the pdpr, pdset, or pdmod commands. 
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Usage 

Values vary by printer model. 

Explanation 

Identifies the default font to be used. 

Value Type 

Single value. 

Values 

A text string up to 4095 characters that contains the 
font name. 

Default 

No default. 

Usage 

Guidelines 

o The document is validated and scheduled against the 

printer attribute fonts-supported. 

i 

Attribute 

Description 

Name 

default-input-tray 

Type 

Settable with the pdcreate or pdset command. 

1 

Usage | 

Explanation 

Identifies an input-tray that contains the medium to be 
used for the document. 

Value Type 

Single value. 

Values 

One of the following fixed values: 


top 

middle 

bottom 

envelope 

manual 

large-capacity 

main 

side 

Default 

No default. 

Usage 

Guidelines 

o The document is validated and scheduled against the 

printer attribute input-trays-supported. 

i 

Attribute 

Description 

Name 

default-medium 

Type 

Settable with the pdcreate or pdset command. 

1 

Usage | 

Explanation 

Identifies the medium to be used for this document. 

Value Type 

Single value. 

Values 

One of the following fixed values or a text string that 
contains the name of the medium. The text string can be 
up to 255 characters long per medium. 
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1 

1 

iso-a4-white 



1 

iso-a4-colored 



1 

iso-a4-transparent 



1 

iso-a3-white 



1 

iso-a3-colored 



1 

iso-a5-white 



1 

iso-a5-colored 



1 

iso-b4-white 



1 

iso-b4-colored 



1 

iso-b5-white 



1 

iso-b5-colored 



1 

na-letter-white 



1 

na-letter-colored 



1 

na-letter-transparent 



1 

na-legal-white 



1 

na-legal-colored 



1 

iso-b5-envelope 



1 

iso-b4-envelope 



1 

iso-c4-envelope 



1 

iso-c5-envelope 



1 

designated-long-envelope 



1 

na-1Oxl3-envelope 



1 

na-9xl2-envelope 



1 

monarch-envelope 



1 

na-number-10-envelope 



1 

na-7x9-envelope 



1 

na-9x11-envelope 



1 

na-10x14-envelope 



1 

na-number-9-envelope 



1 

na-6x9-envelope 



1 

na-10xl5-envelope 



1 

jis-b4-white 



1 

jis-b4-colored 



1 

jis-b5-white 



1 

jis-b5-colored 



1 

executive 



1 

folio 



1 

invoice 



1 

ledger 



1 

quarto 



1 

iso-aO-white 



1 

iso-al-white 



1 

iso-a2-white 



1 

iso-a6-white 



1 

iso-a7-white 



1 

iso-a8-white 



1 

iso-a9-white 



1 

iso-al0-white 



1 

iso-bO-white 



1 

iso-bl-white 



1 

iso-b2-white 



1 

iso-b3-white 



1 

iso-b6-white 



1 

iso-b7-white 



1 

iso-b8-white 



1 

iso-b9-white 



1 

iso-bl0-white 



1 

jis-bO-white 



1 

jis-bl-white 



1 

jis-b2-white 



1 

jis-b3-white 
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jis-b6-white 

jis-b7-white 

jis-b8-white 

jis-b9-white 

jis-blO-white 

a 

b 

c 

d 

e 


Default 


No default. 


Usage 

Guidelines 


o The document is validated against the 

logical printer attribute media-supported and the 
physical printer attribute media-supported, 
o The document is scheduled against the 

physical printer attributes media-supported and 
media-ready. 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Values 


Description 


default-printer-resolution 


Settable with the pdpr, pdset, or pdmod commands. 


Identifies the default printer resolution to be used. 


Single Value. 


One of the following fixed values or an integer from 1 to 


2147483647. 


highest 

lowest 

middle 


Default 


No default. 


Usage 

Guidelines 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Values 


Default 


Description 


descriptor 


Settable with the pdcreate or pdset command. 


Provides a description of this initial-value-document. 


Single value. 


A text string up to 4095 characters that describes this 
initial value document. 


No default. 
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i 


l 


l 


Usage 

Guidelines 

o This attribute is used by the initial-value-document 

object. 

i 

Attribute 

Description 

Name 

document-comment 

Type 

Settable with the pdcreate or pdset command. 

1 

Usage | 

Explanation 

Provides information that is associated with this 

initial-value-document. 

Value Type 

Single value. 

Values 

A text string up to 4095 characters that contains 
information that is associated with this initial value 


document. 


Default | No default. 


Usage 


Guidelines 


Attribute 


Name 


Input 


Description 


document-format 


format 


Synonym 


Type 

Settable with the pdcreate or 

pdset command. 

Usage 

Values vary by printer model. 


Explanation 

Identifies the format of this 

document. 

Value Type 

Single value. 



Values 


One of the following fixed values: 



Fixed Value 

Input Synonym 

ascii 


pci 

hppcl 


hp-pcl 

hpgl 

hp-gl 

Pjl 


postscript 

ps 

ipds 


ppds 


escapep 


epson 


ddif 


interpress 


iso-6429 


line-data 


modca 


regis 
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| scs 



| spdl 



| tek4014 



1 pds 



1 igp 



| codev 



| dsc-dse 



| wps 



| ln03 



| ccitt 



| quic 



1 cpap 



| dec-ppl 



| simple-text 



| npap 



| doc 



| impress 



| pinwriter 



| npdl 



| nec201pl 



| automatic 



| pages 



| lips 



| tiff 



| diagnostic 



| capsl 



| excl 



| lcds 



| xes 



| passthru 


| Default 

| ascii 


| Usage 

| o The document is validated and scheduled against the 


| Guidelines 

| printer attribute document-formats-supported. 


i i i 

i 

| Attribute 

i 

| Description 

i 

| Name 

| document-type 


| Input 

1 type 


| Synonym 



| Type 

| Settable with the pdcreate or pdset command. 


| Usage 

| Values vary by printer model. 


| Explanation 

| Indicates that the document is either a printable 



| document, a font, or some other resource. 


| Value Type 

| Single value. 


| Values 

| One of the following fixed values: 



| file-reference 



| printable 


| Default 

| No default. 



Usage | o The document is validated and scheduled against the 

Guidelines | printer attribute document-types-supported. 
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Attribute 


Description 


Name 


initial-value-document-identifier 


Type 


Specifiable with the pdcreate command. 


Usage 


Explanation! Identifies this initial-value-document object. 


Value Type | Single value. 


Values 


A text string that contains the identification of this 
initial-value-document. Specified in the argument 
ServerName:InitialValueDocumentName of the pdcreate 
command. 


Default 

i 

No 

default. 

Usage 

i 

o 

This attribute is used by the initial-value-document 

Guidelines 

i 


object. 


i 

o 

The value for this attribute must be unique within 


the spooler. 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Values 


Description 


input-tray-select 


Settable with the pdcreate or pdset command. 


Identifies which input tray contains the medium to be 
used for this document. 


Single value. 


One of the following fixed values: 


top 

middle 

bottom 

envelope 

manual 

large-capacity 

main 

side 


Default 


No default. 


Usage | o This document is validated and scheduled against the 

Guidelines | printer attribute input-trays-supported. 


Attribute 


Description 


Name 


number-up 
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Type 


Settable with the pdpr, pdset, or pdmod commands. 


Usage 


Values vary by printer model. 


Explanation 


Specifies the number of source page-images to impose upon 
a single instance of a selected medium, that is, the 
number of source pages to appear on a single printed page. 


The possible values are: 


0 Suppress any number-up operation or embellishment. 

1 1 source page per physical page. 

2 2 source pages per physical page. 

4 4 source pages per physical page. 


Value 


Values 


Type 


Single value. 


One of the following fixed values: 


0 

1 

2 

4 


Default 


No default. 


Usage 

Guidelines 


Attribute 


Name 


Input 

Synonym 


Type 


Usage 


Description 


left-margin 


lm 


Settable with the pdpr, pdset, or pdmod commands. 


Explanation 


Specifies the distance between the left edge of the 
logical page and the left edge of the text area when 
held in the reading orientation. The values are in units 
of characters. 


Value Type 


Values 


Default 


Single value. 


An integer from 1 to 2147483647. 


No default. 


Usage 

Guidelines 


Attribute 


Name 


Input 

Synonym 


Description 


list-of-managers 


managers 
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Type 

Settable with the pdcreate or pdset command. 

1 

Usage | 

Explanation 

Lists the people responsible for the maintenance of this 
initial-value-document object. 

Value Type 

Multiple values. 

Values 

A text string up to 255 characters per person that 
contains the name or user ID of the person responsible 
for this initial-value-document. 

Default 

No default. 

Usage 

Guidelines 

o This attribute is used by the initial-value-document 

object. 

i 

Attribute 

Description 

Name 

logical-printers-ready 

Type 

Non Settable 

1 

Usage | 

Explanation 

Lists the enabled logical printers that reference this 
initial-value-document. 

Value Type 

Multiple values. 

Values 

A text string up to 255 characters per logical printer 
that contains the global IDs of the logical printers. 

Default 

No default. 

Usage 

Guidelines 

o This attribute is used by the initial-value-document 

object. 

o Set by HPDPS when the printer attribute 

printer-initial-value-document of an enabled logical 
printer references this initial-value-document. 
o The printer identification is removed from the list 

if the printer is disabled. 

o This IVD object cannot be deleted while any of the 

printers identified in this list are enabled. 

i 

Attribute 

Description 

Name 

message 

Type 

Settable with the pdcreate or pdset command. 

1 

Usage | 

Explanation 

Provides a message associated with this 
initial-value-document. 

Value Type 

Single value. 
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Values 

A text string up to 4095 characters that contains some 
information about this initial-value-document object. 

Default 

No default. 

Usage 

Guidelines 

o This attribute is used by the initial-value-document 

object. 

i 

Attribute 

Description 

Name 

object-class 

Type 

Non Settable 

1 

Usage | 

Explanation 

Identifies the object class to which this object belongs. 

Value Type 

Single value. 

Values 

The value of this attribute is initial value document. 

Default 

initial-value-document 

Usage 

Guidelines 

o This attribute is used by the initial-value-document 

object. 

i 

Attribute 

Description 

Name 

page-select 

Type 

Settable with the pdpr, pdset, or pdmod commands. 

1 

Usage | 

Explanation 

Specifies the range of pages to be printed. 

Value Type 

Multiple values, however, only the first value is 
currently used. 

Values 

This is a complex attribute which has the following 
components: 


1. beginning-page (an integer page number) 

2. ending-page (an integer page number) 

Syntax 

-x "page-select=beginning-page:ending-page" 


For example: -x "page-select=10:30" prints only pages 10 
through 30. 

Default 

No default. 

Usage 

Guidelines 

o The document is validated against the printer 

attribute page-select-supported, 
o Only numeric value is supported for this attribute, 

o Only one page range may be specified. 

Component 

Description 
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beginning- | An integer from 1 to 2147483647. 
page | 


ending- | An integer from 1 to 2147483647. 

page | 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Values 


Description 


plex 


Settable with the pdcreate or pdset command. 


Indicates whether the page images of the document are 
conditioned for one-sided or two-sided printing and the 
relative orientation of consecutive pages. 


Single value. 


One of the following fixed values: 


simplex 

duplex 

tumble 


(single sided) 

(double sided) 

(double sided, every other page upside-down) 


Default 


No default. 


Usage 

Guidelines 


o This document is validated and scheduled against the 
printer attribute plexes-supported. 
o HPDPS defaults "sides=2" when plex=duplex. HPDPS does 
not currently perform any other conditioning when 
plex=duplex. 


Attribute 


Name 


Input 

Synonym 


Type 


Usage 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


printer-pass-through 


other-options 


Settable with the pdcreate or pdset command. 


Allows specific printer information to be submitted along 
with the document. 


Single value. 


A text string up to 4095 characters that contains the DSS 
information. 


No default. 


Attribute 


Description 
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Name 

Type 


right-margin 

Settable with the pdpr, pdset, or pdmod commands. 


Usage 

Explanation 


Specifies the distance between the right edge of the 
logical page and the right edge of the text area when 
held in the reading orientation. The values are in units 
of characters. 


Value Type 
Values 


Single value. 

An integer from 1 to 2147483647. 
No default. 


Default 


Usage 

Guidelines 


Attribute 

Name 


Description 

sides 

Settable with the pdcreate or pdset command. 


Type 

Usage 

Explanation 


Specifies whether the document is to printed on one side 
or both sides of the media. 


Value Type 
Values 


Single value. 

An integer of 1 or 2. 


Default 


Usage 

Guidelines 


o The document is validated and scheduled against the 
printer attribute sides-supported. 


Attribute 

Name 


Description 

top-margin 

tm 


Input 

Synomym 


Type 

Usage 

Explanation 


Settable with the pdpr, pdset, or pdmod commands. 


Specifies the distance between the top edge of the 
logical page and the top edge of the text area when 
held in the reading orientation. The values are in units 
of characters. 


Value Type 
Values 


Single value. 

An integer from 1 to 2147483647. 
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Default 


No default. 


Usage 

Guidelines 
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NAME 

pd_att_ivjob - list of attributes for an HPDPS initial valuejob object 

DESCRIPTION 

The following is a list of valid attributes and values for the initial valuejob object class of the HP Distri¬ 
buted Print Service. I nitial-value-job objects are used to set values for job attributes. 


Attributes for an Initial ValueJ ob Object 


1 

Settable Attribute Listing 

| Specifiable Attribute Listing 

i 


descriptor 

| There are no specifiable 



interface-program-method 

| attributes for a 



job-batch 

| initial-value-document object. 



job-comment 

i 



job-client-id 

i 



j ob-dis card-1ime 

i 



j ob-end-me s s age 

i 



job-finishing 

i 



job-hold 

i 



job-message-to-operator 

i 



job-name 

i 



job-originator 

i 



job-owner 

i 



job-print-after 

i 



job-priority 

i 



job-retention-period 

i 



job-sheets 

i 



job-start-message 

i 



list-of-managers 

i 



message 

i 



notification-profile 

i 



physical-printers-requested 

i 



printer-locations-requested 

i 



printer-models-requested 

i 



printer-types-requested 

i 



results-profile 

i 



Note: In the following table, the attributes are used to set job 

attributes or are used as defaults for a job unless otherwise 
noted. 


Table 1-1. 

Initial Value Job Attributes 

Attribute 

Description 

Name 

associated-server 

Type 

Non Settable 

Explanation 

Identifies the name of the spooler in which this 
initial-value-job object resides. 

Value Type 

Single value. 

Values 

A text string that contains the server name. Set to the 
server name of the pdcreate command argument 

ServerName:InitialValueJobName when this object is 
created. 
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Default 


No default. 


Usage | o This attribute is used by the initial-value-job 

Guidelines | object. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


descriptor 


Settable with the pdcreate or pdset commands. 


Provides a description of this initial-value-job. 


Single value. 


A text string up to 4095 characters that describes this 
initial-value-job object. 


No default. 


o This attribute is used by the initial-value-job 
object. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Description 


initial-value-job-identifier 


Non Settable 


Identifies this initial-value-job object within the 
spooler. 


Single value. 


Values 


A text string up to 255 characters that contains the name 
of this initial-value-job object. Set to the name used 
in the pdcreate command argument 

ServerName:InitialValueJobName when this object was 
created. 


Default 


No default. 


Usage | o This attribute is used by the initial-value-job 

Guidelines | object. 

| o The value for this attribute must be unique within a 

| spooler. 


Attribute 

Description 



Name 

interface-program-method 



Input 

Synonym 

ip-method 



Type 

Settable with the pdpr, pdset or 

pdmod 

commands. 

Explanation 

Specifies the invocation method 

of the 

interface program. 

Value Type 

Single value. 
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Values 


One of the following fixed values: 


hpdps 

ip 


Default 


hpdps 


Usage 

Guidelines 


o The job is validated against the printer attribute 
interface-program-methods-supported. 
o If the value hpdps is specified, the interface program 
is invoked to print one job result-set as follows: 

- The value of the job-copies component of the job 
results-profile attribute is passed as the 4th 
argument of the interface program. 

- Each document is duplicated n times before being 
passed to the interface program, where n is the 
value of the document copy-count attribute. 

o If the value lp is specified, the interface program is 
invoked to print each job copy in one job result set: 

- The value of document attribute copy-count is passed 
as the 4th argument of the interface program. 

- The interface program is invoked n times, where n 
is the value of the job-copies component of the job 
results-profile attribute. 


Attribute 


Name 


Type 


Description 


job-batch 


Settable 


Explanation 


Specifies that the job you are submitting is being marked 
as a specific type of job. HPDPS processes this job only 
on a physical printer which is ready to print that 
specified job-batch type. 


Value Type 


Single value. 


Values 


You can enter a value up to 4095 characters that contains 
the job-batch name. 


Default 


No default. 


Usage | HPDPS schedules this attribute against the physical 

Guidelines | printer's job-batches-ready attribute. 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Description 


job-client-id 


local-id 


Settable with the pdcreate or pdset commands. 


The local job identifier. 


Single value. 


HP-UX Release 11.0: October 1997 


-3- 


Section 5-123 






















pd_att_ivjob(5) 


pd_att_ivjob(5) 


Values | A text string up to 255 characters that contains the 

| local ID (an integer). This value is generated 
| automatically by the DPS client program and is unique for 
| a given user ID. The local ID is mapped to a global ID 
| (the job-identifier job attribute) that is unique for the 
| system. 


Default | No default. 


Usage 

Guidelines 


Attribute 


Name 


Input 

Synonym 


Type 


Usage 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


job-comment 


comment 


Settable with the pdcreate or pdset commands. 


Provides information that is associated with this print 
job. 


Single value. 


A text string up to 4095 characters that provides some 
information about the job. 


No default. 


Attribute 


Name 


Input 

Synonym 


Type 


Description 


j ob-dis card-time 


dis card-time 


Settable with the pdcreate or pdset commands. 


Explanation 


Specifies the time and calendar date or time at which 
this print job is to be discarded, whether or not it has 
printed. 


Value Type | Single value. 


Values | Local time format; USA format is "HH:MM:SS mm/dd/yy" or 

| HH:MM:SS. The string must be enclosed in quotes if the 
| date is used. 


Default 


No default. 


Usage 

Guidelines 
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Attribute 

1 

| Description 


Name 

| job-end-message 


Input 

Synonym 

| end-message 


Type 

| Settable with the pdcreate or pdset commands. 


Explanation 

| Provides the message that is to be sent to an 
| when this job completes printing. 

operator 

Value Type 

| Single value. 


Values 

i 

| A text string up to 4095 characters that contains 
| information on how the printed output is to be handled, 

| such as special delivery instructions. 

Default 

i 

| No default. 


Usage 

Guidelines 

i 

| o Validate and schedule against the printer attribute 

| end-message-supported. 

| o This message is sent if the 

| physical printer attribute end-message-supported is 

| "true" for the physical printer the job is submitted 

| to. 

| o The physical printer attribute notify-operator 

| determines which operators receives the message. 

i 

Attribute 

i 

| Description 


Name 

| job-finishing 


Type 

| Settable 


Explanation 

| Identifies the desired finishing process to be 
| the printed output. 

applied to 

Value Type 

| Single value. 


Values 

| Fixed Value 
| none 
| staple 

| top-left-staple 


Default 

| none. 


Usage 

Guidelines 

i 

| o Used to request a finishing process to be applied to 
| the printed output. 

i 

Attribute 

i 

| Description 


Name 

| job-hold 


Input 

Synonym 

| hold 


Type 

| Settable with the pdcreate or pdset commands. 
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Explanation 


Value Type 


Values 


Indicates whether a print job can be scheduled for 
printing. 


Single value. 


One of the following fixed values: 


Fixed Value Input Synonym 

true yes 

false no 


Default 


No default. 


Usage 

Guidelines 


o If true, the job-state of the job is set to hold and 
the job-state-reasons is set to job-hold-set. 
o If held, the job remains in the queue until: 

- job-hold is set to "false" and the job can 
continue. 

— The time specified in the job-discard-time 
attribute is reached. 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Default 


Description 


job-message-to-operator 


message-to-operator 


Settable with the pdcreate or pdset commands. 


Provides a message that is to be sent to an operator when 
a job is added to a queue. 


Single value. 


A text string up to 4095 characters that contains 
information about this job such as job processing 
requirements or some type of special handling. 


No default. 


Usage | o The person that is to receive this message is 

Guidelines | identified by the queue attribute notify-operator. 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Description 


job-name 


name 


Settable with the pdcreate or pdset commands. 


Provides an identifier that may be printed on the job 
start sheet. 


Single value. 


A text string up to 255 characters that contains human 
readable job identification. 
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Default 

No default. 

Usage 

Guidelines 

o This identification may be printed on the banner page. 

i 

Attribute 

Description 

Name 

job-originator 

Input 

Synonym 

originator 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Identifies the user ID of the person who submits a job. 

Value Type 

Single value. 

Values 

A text string up to 255 characters that contains the user 
ID. This value is set automatically by the DPS client 
program so this attribute is not used by a job that uses 
this initial-value-job. 

Default 

No default. 

i 

Usage | 

Guidelines | 

1 

Attribute 

Description 

Name 

job-owner 

Input 

Synonym 

owner 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Identifies the name or user ID of the person responsible 
for this print job. 

Value Type 

Single value. 

Values 

A text string up to 255 characters that contains the 
global ID of a person that is to be responsible for this 
job. 

Default 

No default. 

Usage 

Guidelines 

o Use this attribute if you want to specify a person to 

be responsible for a job other than the person who 
submits the job. 

o This identification may be printed on the auxiliary- 

sheet page. 

i 

Attribute 

Description 

Name 

job-print-after 
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Input 

Synonym 

print-after 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Specifies the time or time and calendar date after which 
the print job may be scheduled for printing. 

Value Type 

Single value. 

Values 

Local time format; USA format is HH:MM:SS or "HH:MM:SS 
mm/dd/yy". The string must be enclosed in quotes if the 
date is used. 

Default 

No default. 

Usage 

Guidelines 

o The job-state for this job is set to held and the 

job-state-reason is set to job-print-after-specified. 

i 

Attribute 

Description 

Name 

job-priority 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Specifies a number representing the scheduling priority 
for the job. This attribute is used by queues that 
employ a priority based scheduler. A higher value 
specifies a higher priority. 

Value Type 

Single value. 

Values 

An integer from 1 to 100. 

Default 

No default. 

Usage 

Guidelines 

o This value should not be set higher than "50" for 

initial-value-job objects to be used by all users. 

If a value greater than 50 is specified, the value is 
lowered to "50" when the job is submitted, 
o A job submitted by an administrator can have any 

valid value. 

i 

Attribute 

Description 

Name 

job-retention-period 

Input 

Synonym 

retention-period 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Specifies the period of time following job completion 
that a job is to be retained before being discarded by 
the spooler. 

Value Type 

Single value. 

Values 

[HH:]MM. Unit is minutes; hours are optional. 
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Default 


Usage 

Guidelines 


No default. 


Attribute 


Name 


Input 

Synonym 


Type 


Usage 


Explanation 


Value Type 


Values 


Description 


job-sheets 


job-sheets 


Settable with the pdpr, pdset or pdmod commands. 


Values vary by printer model. 


Specifies the auxiliary sheets that are inserted into the 
job. 


Single value. 


One of the following fixed values: 


none 

job-separators 

job-set-start 

job-set-end 

job-set-wrap 

job-set-start-copies-separate 

job-set-end-copies-separate 

job-set-wrap-copies-separate 

job-copy-start 

j ob-copy-end 

j ob-copy-wrap 


Default 


No default 


Usage | o The job is validated and scheduled against the 

Guidelines | printer attribute job-sheets-supported. 


Attribute 


Name 


Input 

Synonym 


Type 


Description 


job-start-message 


start-message 


Settable with the pdcreate or pdset commands. 


Explanation 


Provides a message that is to be sent to an operator when 
a job is sent to a physical printer conveying information 
about job processing. 


Value Type 


Single value. 


Values 


A text string up to 4095 characters that provides some 
information about the job such as this job is very 
important. 


Default 


No default. 
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Usage 

Guidelines 

o Validate and schedule against the printer attribute 

start-message-supported. 
o This message is sent if the 

physical printer attribute start-message-supported is 
"true" for the physical printer the job is submitted 
to. 

o The persons that are to receive this message are 

identified in the physcial printer attribute 
notify-operator. 

i 

Attribute 

Description 

Name 

list-of-managers 

Input 

Synonym 

managers 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Identifies the persons responsible for the maintenance of 
this initial-value-job object. 

Value Type 

Multiple values. 

Values 

A text string up to 255 characters per person that 
contains the name or user ID of the person responsible. 

Default 

No default. 

Usage 

Guidelines 

o This attribute is used by the initial-value-job 

object. 

i 

Attribute 

Description 

Name 

logical-printers-ready 

Type 

Non Settable. 

Explanation 

Lists the enabled logical printers that reference this 
initial-value-job object. 

Value Type 

Multiple values. 

Values 

Set by HPDPS, it contains the global ID of the logical 
printer that is enabled or disabled and references this 
initial-value-job object. 

Default 

No default. 

Usage 

Guidelines 

o Values are added when a logical printer is enabled 

and references this initial-value-job through its 
printer-initial-value-job attribute. 
o Values are removed when logical printers that 

reference this initial-value-job are disabled, 
o This initial-value-job object cannot be deleted until 

all printers have been removed from this list. 


Attribute 
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Name 

message 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Provides a message associated with the initial-value-job 
object. 

Value Type 

Single value. 

Values 

A text string up to 4095 characters that provides 
information about this object. 

Default 

No default. 

Usage 

Guidelines 

o This attribute is used by the initial-value-job 

object. 

i 

Attribute 

Description 

Name 

notification-profile 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Designates the people that are to be notified when 
specified events relating to this job and how the people 
are to be notified. 

Value Type 

Multiple values. 

Values 

This is a complex attribute which has the following 
components: 


o event-identifiers 
o delivery-method 
o event-comment 
o delivery-address 
o locale 

Syntax 

-x "notification-profile={event-identifiers=value 
delivery-method=value event-comment='text' 
delivery-address=value locale=value}" 


For example, 


-x "notification-profile={event-identifiers= 
class-state-changed job-completed 
delivery-method=electronic-mail 
event-comment='job progressing' 
delivery-address=joe@newhope 
locale=C}" 

Component 

Description 

event- 

identifiers 

Explanation: Specifies the events for which the user 
is to receive notification that something has taken 
place. 

Value Type: Multiple values. 

Values: Any of the values listed for spooler 

attribute events-supported in pd_att_spooler. 
Default: No default. 
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delivery- 

method 


event- 

comment 


delivery 

-address 


locale 


Explanation: Specifies if or how the user is to 
receive the information. 

Value Type: Single value. 

Values: One of the following fixed values: 

Fixed Value Input Synonym 

electronic-mail e-mail, email 

file 

file-add-to 

message 

none 

Default: electronic-mail 


Explanation: This textual information is appended to 
the event message. 

Value Type: Single value. 

Values: A text string up to 4095 characters that 
supplies additional information. 

Default: No default. 


Explanation: The address of the person that is to 
receive the event messages. 

Value Type: Single value. 

Values: A text string that contains the name and node 
of the person that is to receive the information. 
Default: No default. 


Explanation: Identifies the locale of the person that 
is to receive the message. 

Value Type: Single value. 

Values: A text string that contains the locale 
identification of the person that is to receive the 
notification. This information is used to determine 
the language and coded character set that the 
notification is sent in. 

Default: No default. 


Attribute 

Description 


Name 

object-class 


Type 

Non Settable 


Explanation 

Identifies the object class tc 

which this object belongs. 

Value Type 

Single value. 


Values 

The value of this attribute is 

initial value job. 

Default 

initial-value-job 


Usage 

Guidelines 

o This attribute is used by 

object. 

the initial-value-job 

i 

Attribute 

Description 


Name 

physical-printers-requested 


Type 

Settable with the pdcreate or 

pdset commands. 
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Explanation 


Value Type 


Values 


Default 


Identifies the physical printers requested for printing 
the job. 


Multiple values. 


A text string up to 255 characters per printer that 
contains the name of the physical printer. 


No default. 


Usage 

Guidelines 


o The job will be printed on one of the requested 
physical printers, if possible, 
o Validate and schedule against the printer attribute 
printer-name. 

o Validate and schedule against the printer attribute 
start-message-supported. 
o This message is sent if the 

physical printer attribute start-message-supported is 
"true" for the physical printer the job is submitted 


to. 


o The persons that are to receive this message are 
identified in the physcial printer attribute 
notify-operator. 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Default 


Description 


printer-locations-requested 


locations-requested 


Settable with the pdcreate or pdset commands. 


Identifies the locations where a job has been requested 
to be printed. 


Multiple values. 


A text string up to 4095 characters per printer that 
contains the physical location of the printer being 
requested. 


No default. 


Usage 

Guidelines 


o The job will be printed on a printer at one of the 
requested locations, if possible, 
o The job is validated and scheduled against the 
printer attribute printer-locations. 
o Any individual value specified for this attribute can 
select more than one physical printer. For example, 
the printers could all be in the same location, such 
as a printer room. 

o The values for both the job and printer attributes 
are text strings that can include blanks. They must 
match exactly for validation to occur. 


Attribute 


Description 


Name 


printer-models-requested 
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Input 

Synonym 


Type 


Explanation 


Value Type 


models-requested 


Settable with the pdcreate or pdset commands. 


Specifies the model IDs of the printers on which the job 
is to be printed. 


Multiple values. 


Values 


A text string up to 4095 characters per printer that 
contains the model of the printer that can be used to 
print this job. 


Default 


No default. 


Usage 

Guidelines 


o The job will be printed on a requested model, if 
possible. 

o The job is validated and scheduled against the 
printer-attribute printer-model. 
o Any individual value specified for this attribute 
can select more than one physical printer. 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Description 


printer-types-requested 


types-requested 


Settable with the pdpr, pdset, or pdmod commands. 


Identifies the type of the printer to be used for printing 
the job. 


Multiple values 


Any of the following fixed values: 


other 

electrographic-led 

electrographic-laser 

electrographic-other 

impact-moving-head-dot-matrix-9-pin 

impact-moving-head-dot-mat rix-2 4-pin 

impact-moving-head-dot-matrix-other 

impact-moving-head-fully-formed 

impact-band 

impact-other 

inkjet-aqueous 

inkjet-solid 

inkjet-other 

pen 

thermal-transfer 

thermal-sensitive 

thermal-diffusion 

thermal-other 

electro-erosion 

electro-static 

photographic-microfiche 

photographic-imagesetter 
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photographic-other 

ion-deposition 

E-beam 

typesetter 


Default 


No default 


Usage | o The job is validated and scheduled against the 

Guidelines | printer attribute printer-types. 


Attribute 


Name 


Type 


Description 


results-profile 


Settable with the pdpr, pdset, or pdmod commands. 


Explanation 


Specifies the delivery method for the hardcopy output, 
and designates who is to receive output and the number of 
copies (per recipient). 


Value Type 


Multiple values. 


Values 


This is a complex attribute which has the following 
components: 


1. delivery-method 

2. results-set-comment 

3. delivery-address 

4. job-copies 

5. output-bin 


Syntax 


-x M results-profile=\ 

dm value:rc value:da value:jc value:ob value" 


For example: -x ":::2:top" 


Usage 

Guidelines 


Only job-copies and output-bin components are used. 


Component 


Description 


delivery- 

method 


Explanation: Specifies how the person is to receive 
the job output. 

Value Type: Single value. 

Values: The only value for this component is the 
following fixed value: 
pickup 

Default: pickup 


results- 

set-comment 


Explanation: Supplies a text string that describes 
the results-set value. 

Value Type: Single value. 

Values: A text string up to 4095 characters that 

provides information such as "Please staple this 
document". Or information such as "Please read 
before meeting tomorrow" for the person that is to 
receive the document. This information may be 
printed on start-sheets. 

Default: No default. 


delivery- 


Explanation: The address of the person that is to 
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address | receive the job output. 

| Value Type: Single value. 

| Values: A text string that contains the address. 


job-copies | Explanation: Specifies how many copies of the job the 
| person is to receive. 

| Value Type: Single value. 

| Values: An integer (cannot be 0). 

| Default: 1 


output-bin 


Explanation: Specifies the output-bin to be used. The 

job is validated against the physical printer attribute 
output-bins-supported. 

Value Type: Single value. 

Values: One of the following fixed values: 


top 

middle 

bottom 

side 

left 

right 

face-up 

face-down 

large 

private 

collator 

Default: No default. 


The job is validated against the printer attribute 
output-bins-supported. 
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NAME 

pd_attj°b - list of attributes for an HP DPS job object 

DESCRIPTION 

The following is a list of valid attributes and values for thejob object class of the HP Distributed Print Ser¬ 
vice. 


Attributes for a J ob Object 


Settable Attribute Listing 


interface-program-method 

job-batch 

job-comment 

j ob-dis card-time 

j ob-end-me s s age 

job-finishing 

job-hold 

job-message-from-administrator 

job-message-to-operator 

job-name 

job-print-after 

job-priority 

job-retention-period 

job-sheets 

job-start-message 

notification-profile 

physical-printers-requested 

printer-locations-requested 

printer-models-requested 

printer-mopy-requested 

printer-types-requested 

results-profile 


Specifiable Attribute Listing 


initial-value-job 

job-originator 

job-owner 

printer-name-requested 


Table 1-1. Job Attributes 


Attribute 

Description 

Name 

client-basic-ds 

Type 

Non Settable 

Explanation 

Identifies the host to contact for information about the 
source environment from which the job was submitted. This 
attribute is present only when the job is submitted to an 
HPDPS Gateway printer. 

Value Type 

Single value. 

Values 

A text string containing the IP address of the host in 
dotted decimal format. 

Default 

No default. 

Usage 

The destination environment uses this attribute to 

Guidelines 

contact the source environment, such as to perform 
dce-pipe-pull document transfers. The IP address is of a 
host that runs a basicdsd server for the source 
environment. 
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Attribute 

Description 

Name 

completion-time 

Type 

Non Settable 

Explanation 

Identifies the time when the job completed printing. Set 
by HPDPS. 

Value Type 

Single value. 

Values 

Local time format; USA is "HH:MM:SS mm/dd/yy" 

Default 

No default. 

Usage 

Guidelines 

Provides status information. 

i 

Attribute 

Description 

Name 

current-job-state 

Input 

Synonym 

job-state 

Type 

Non Settable 

Explanation 

Identifies the current state of the job. 

Value Type 

Single value. 

Values 

One of the following fixed values: 


canceled 

held 

paused 

pending 

pre-processing 

processing 

retained 

terminating 

timed-out 

unknown 

Default 

No default. 

Usage 

Guidelines 

o The value is set and updated by HPDPS as the job 

progresses. 

i 

Attribute 

Description 

Name 

device-name-assigned 

Type 

Non Settable. 

1 

Usage | 

Explanation 

Identifies the path name of the device special file 
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associated with the physical printer. 


Value Type 


Single Value. 


Values 


A text string that contains the path name of the device 
associated with the printer. Implicitly set by HPDPS if 
the value of printer attribute attachment-type is serial 
or parallel. 


Default 


No default. 


Usage 

Guidelines 


This attribute is intended for use in the ipmap 
file to pass the device path name to the interface 
program that accesses the device. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Description 


initial-value-job 


Specifiable with the pdpr command. 


Identifies the initial-value-job object in the spooler 
that is to be used to create the job object during job 
submission. 


Single value. 


The name of an existing initial-value-job object. 


No default. 


Usage 

Guidelines 


o If a value is specified for this attribute, the job 
uses the attributes and values from the object unless 
those are overridden by attribute values supplied at 
the command line. 


Attribute 

| Description 


Name 

| interface-program-method 


Input 

Synonym 

| ip-method 


Type 

| Settable with the pdpr, pdset or pdmod 

commands. 

Explanation 

| Specifies the invocation method of the 

interface program. 

Value Type 

| Single value. 


Values 

| One of the following fixed values: 



hpdps 

ip 


Default 


hpdps 


Usage 

Guidelines 


o The job is validated against the printer attribute 
interface-program-methods-supported. 
o If the value hpdps is specified, the interface program 
is invoked to print one job result-set as follows: 
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- The value of the job-copies component of the job 
results-profile attribute is passed as the 4th 
argument of the interface program. 

- Each document is duplicated n times before being 
passed to the interface program, where n is the 
value of the document copy-count attribute. 

o If the value lp is specified, the interface program is 

invoked to print each job copy in one job result set: 

- The value of document attribute copy-count is passed 
as the 4th argument of the interface program. 

- The interface program is invoked n times, where n 
is the value of the job-copies component of the job 
results-profile attribute. 


1 

Attribute 

Description 

1 

1 

Name 

intervening-jobs 

1 

1 

1 

Input 

Synonym 

position-in-queue, queue-position 

1 

1 

1 

Type 

Non Settable 

1 

1 

1 

Explanation 

Indicates the number of jobs in the queue before this 
job. 

1 

1 

1 

Value Type 

Single value. 

1 

1 

1 

Values 

An integer from 0 to 2147483647. Set and updated by 

HPDPS. 

1 

1 

1 

Default 

No default. 

1 

1 

1 

1 

Usage 

Guidelines 

o Provides status information. 

o A value of zero (0) means that the job is currently 

printing. 

1 

1 

1 

1 




1 

1 

Attribute 

Description 

1 

1 

1 

Name 

job-batch 

1 

1 

1 

Type 

Settable 

1 

1 

1 

1 

1 

1 

Explanation 

Specifies that the job you are submitting is being marked 
as a specific type of job. HPDPS processes this job only 
on a physical printer which is ready to print that 
specified job-batch type. 

1 

1 

1 

1 

1 

Value Type 

Single value. 

1 

1 

1 

Values 

You can enter a value up to 4095 characters that contains 
the job-batch name. 

1 

1 

1 

Default 

No default. 

1 

1 

1 

Usage 

Guidelines 

HPDPS schedules this attribute against the physical 
printer's job-batches-ready attribute. 

1 

1 





1 

Attribute 

Description 

1 
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Name 

job-client-id 

Input 

Synonym 

local-id 

Type 

Non Settable 

Explanation 

Identifies the local job identifier. 

Value Type 

Single value. 

Values 

The local ID. HPDPS sets this value from 1 through the 
number specified as the value for the PDIDTABLE 
environment variable. 

Default 

No default. 

Usage 

Guidelines 

o Generated by the client program and is unique for a 

given user ID. The local ID is mapped to global ID 
(the job attribute job-identifier), which is unique 
for the system. 

i 

Attribute 

Description 

Name 

job-comment 

Input 

Synonym 

comment 

Type 

Settable with the pdpr, pdset or pdmod commands. 

Explanation 

Provides information that is associated with this job. 

Value Type 

Single value. 

Values 

A text string up to 4095 characters that contains some 
information associated with this job. 

Default 

No default. 

i 

Usage | 

Guidelines | 

1 

Attribute 

Description 

Name 

job-copies-completed 

Type 

Non Settable 

Explanation 

Indicates the total number of copies of the job that have 
finished printing. 

Value Type 

Single value. 

Values 

An integer from 0 to 2147483647. Set and updated by 

HPDPS. 

Default 

No default. 
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Usage | o This value is updated at the completion of each 

Guidelines | result-set. 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Description 


j ob-dis card-time 


dis card-time 


Settable with the pdpr, pdset or pdmod commands. 


Specifies the time or time and calendar date at which the 
print job is to be discarded, whether or not it has 
printed. 


Single value. 


Values 


Local time format: USA format is HH:MM:SS or "HH:MM:SS 
mm/dd/yy" The string must be quoted if the date is 
specified. 


Default 


No default 


Usage 

Guidelines 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Default 


Description 


j ob-end-me s s age 


end-message 


Settable with the pdpr, pdset or pdmod commands. 


Provides a message conveying information about output 
handling when the job completes printing. 


Single value. 


A text string up to 4095 characters that contains 
instructions to an operator such as special output 
delivery instructions. 


No default. 


Usage 

Guidelines 


o Validate and schedule the job against the 
printer attribute end-message-supported, 
o This message is sent if the attribute 

end-message-supported is "true" for the physical 
printer to which the job is submitted, 
o The printer attribute notify-operator identifies the 
operators that are to receive the message. 


Attribute 


Description 


Name 


job-finishing 
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Type 

Settable 


Explanation 

Identifies the desired finishing process to be applied to 
the printed output. 

Value Type 

Single value. 


Values 

Fixed Value 

none 

staple 

top-left-staple 


Default 

none. 


Usage 

Guidelines 

o Used to request a finishing process 
the printed output. 

to be applied to 

i 

Attribute 

Description 


Name 

job-hold 


Input 

Synonym 

hold 


Type 

Settable with the pdpr, pdset or pdmod 

commands. 

Explanation 

Indicates whether the print job can be 
printing. 

scheduled for 

Value Type 

Single value. 


Values 

One of the following fixed values: 



Fixed Value Input Synonym 

true yes 

false no 


Default 

i 

false 



Usage 

i 

o 

If true, 

the 

job-state changes to hold and the 

Guidelines 

i 

i 

o 

job-state-reasons is set to job-hold-set. 

If held, the job remains in the queue until: 


job-hold is set to "false" and the job can 
continue. 

The time specified in the job-discard-time 
attribute is reached. 


Attribute 

Description 


Name 

job-identifier 


Input 

Synonym 

global-id 


Type 

Non Settable 


Explanation 

The global job identifier, 
job within the server. 

It uniquely identifies the 

Value Type 

Single value. 
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Values 

The global ID. Set by HPDPS. 


i 

Default 

No default. 


i 

Usage | 

Guidelines | 

1 

Attribute 

Description 


Name 

job-message-from-administrator 


Input 

Synonym 

message-from-administrator 


Type 

Settable; see Usage Guidelines. 


Explanation 

Describes the reasons that the job is being or has 
changed. 

been 

Value Type 

Single value. 


Values 

A text string up to 4095 characters that provides 
information concerning why a given action has been 

taken. 

Default 

No default. 


Usage 

o Set with the value specified with the -m flag or the 

Guidelines 

command attribute message when included: 



With the pdmod or pdset command and the 
object class is job. 

With the pdpause, pdresume, pdpromote, or pdrm 
commands. 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Default 


Description 


job-message-to-operator 


message-to-operator 


Settable with the pdpr, pdset or pdmod commands. 


Provides a message that is to be sent to an operator when 
the job is added to a queue. 


Single value. 


A text string up to 4095 characters that contains 
information about job processing requirements such as 
some type of special handling. 


No default. 


Usage | o The operator that is to receive the message is 

Guidelines | identified in the queue attribute notify-operator. 


Attribute 


Description 
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Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Default 


job-name 


name 


Settable with the pdpr, pdset or pdmod commands. 


Provides a human readable job identification. 


Single value. 


A text string up to 255 characters that contains the 
identification. 


The file name of the first document in the job. 


o This identification may be printed on the banner page. 


Description 


job-originator 


originator 


Specifiable with the pdpr command. 


Identifies the user ID, or user ID and node, of the 
person who submitted the job, or the name of the program 
that initiated the job. 


Single value. 


A text string up to 255 that contains the global ID. 


username@node of person submitting the job. 


Description 


job-owner 


owner 


Specifiable with the pdpr command. 


Identifies the name or user ID of the person responsible 
for the print job. 


Single value. 


A text string up to 255 that contains the global ID of 
person that is to be responsible for this job. 


The value of the job attribute job-originator. 
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Usage 

Guidelines 


o Use this attribute if you want to specify a person to 
be responsible for the job other than yourself, 
o This identification may be printed on the auxiliary- 
sheet . 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Description 


job-print-after 


print-after 


Settable with the pdpr, pdset or pdmod commands. 


Specifies the time or time and calendar date after which 
the print job may be scheduled for printing. 


Single value. 


Values 


Local time format; for USA HH:MM:SS or "HH:MM:SS 
mm/dd/yy". The string must be quoted if the date is 
specified. 


Default 


No default. 


Usage | o If submitted before the specified time, job-state is 

Guidelines | set to held and the job-state-reasons is identified as 

| job-print-after-specified for the job. 


Attribute 


Name 


Type 


Description 


job-priority 


Settable with the pdpr, 


pdset or pdmod commands. 


Explanation 


Specifies a number representing the scheduling priority 
for the job. This attribute is used by queues that 
employ a priority based scheduler. A higher value 
specifies a higher priority. 


Value Type 


Single value. 


Values 


An integer from 1 to 100. 


Default 


50 


Usage 

Guidelines 


o A job submitter should not set this value higher than 
"50" unless the job submitter is an administrator. 

If a value greater than 50 is specified, the value is 
set to "50". 

o An administrator can set the value to any valid 
value. 


Attribute 


Description 


job-retention-period 

retention-period 


Input 
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Synonym 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Settable with the pdpr, pdset or pdmod commands. 


Specifies the period of time following job completion 
that the job is to be retained before being discarded by 
the spooler. 


Single value. 


[HH:]MM. Unit is minutes; hours are optional. 


No default. 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Values 


Description 


job-sheets 


Settable with the pdpr, pdset or pdmod commands. 


Values vary by printer model. 


Specifies the auxiliary sheets that are inserted into the 
job. 


Single value. 


One of the following fixed values: 


none 

job-separators 

job-set-start 

job-set-end 

job-set-wrap 

job-set-start-copies-separate 

job-set-end-copies-separate 

job-set-wrap-copies-separate 

job-copy-start 

j ob-copy-end 

j ob-copy-wrap 


Default 


No default 


Usage | o The job is validated and scheduled against the 

Guidelines | printer attribute job-sheets-supported. 


Most printer models support the following 2 values: 
o none 

No auxiliary sheets, or banner pages, are 
printed with the job. 

o job-set-start 

A banner page is printed at the start of each 
job-result-set. For most printers, this means 
a single banner page is printed before the 
job documents are printed. 
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Attribute 

Description 

Name 

| job-start-message 

Input 

Synonym 

| start-message 

Type 

| Settable with the pdpr, pdset or pdmod commands. 

Explanation 

| Provides a message that is to be sent to an operator when 
| the job is added to a queue conveying information about 
| job processing. 

Value Type 

| Single value. 

Values 

| A text string up to 4095 characters that contains 
| information about the job such as, "This job is very 
important; call me if there any problem." 

Default 

| No default. 

Usage 

Guidelines 

| o Validate and schedule the job against the 

| printer attribute start-message-supported. 

| o A message is sent if the physical printer attribute 

start-message-supported is "true" for the physical 
| printer to which the job is submitted. 

o The printer attribute notify-operator contains the 

| identity of the operators that are to receive the 

| message. 

i 

Attribute 

| Description 

Name 

| job-state-reasons 

Input 

Synonym 

| state-reasons, reasons 

Type 

| Non Settable 

Explanation 

Identifies the reasons that a job is in the held, 

| terminating, or retained state. If this attribute value 
| is blank, the job is not in one of these states. 

Value Type 

Multiple values. 

Values 

| Any of the following fixed values: 


aborted-by-system 
| canceled-by-operator 
canceled-by-user 
| completed-with-errors 
| completed-with-warnings 
| completed-successfully 
| job-hold-set 
| job-print-after-specified 
| required-resources-not-ready 
| required-resources-not-supported 

Default 

| No default. 
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Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Description 


job-submission-complete 


Non Settable 


Indicates whether all documents of the job have been 
received by the spooler. 


Single value. 


One of the following fixed values: 

Fixed Value Input Synonym 

true yes 

false no 


No default. 


Description 


modification-time 


Non Settable 


Identifies the time this job was last modified. 


Single value. 


Local time format. For the USA; "HH:MM:SS mm/dd/yy" 


No default. 


Description 


name-of-last-accesser 


last-accesser, last-modifier 


Non Settable 


Identifies the person or name of the program that 
submitted the job, or most recently modified the job. If 
the job was submitted or modified by a person, the value 
is the login ID for that user. 


Single value. 


A text string up to 255 characters that contains the 
login ID of the user or a global ID. Set by HPDPS. 
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Default 

No default. 

i 

Usage | 

Guidelines | 

1 

Attribute 

Description 

Name 

new-job-identifier 

Input 

Synonym 

new-identifier, new-id 

Type 

Non Settable 

Explanation 

Identifies the name of the spooler to which this job has 
been reassigned. Also a new global job identifier, if a 
job was resubmitted to a logical printer on a different 
spooler. 

Value Type 

Single value. 

Values 

server-name:job-identifier or server-name. Set by HPDPS. 

Default 

No default. 

Usage 

Guidelines 

o If the job is submitted to a logical printer on the 

same spooler, the job identifier remains the same. 

i 

Attribute 

Description 

Name 

notification-profile 

Type 

Settable with the pdpr, pdset or pdmod commands. 

Explanation 

Designates which persons are to be notified of specific 
events relating to this job, and how the persons are to 
be notified. 

Value Type 

Multiple Values 

Values 

This is a complex attribute, which has the following 
components: 


o event-identifiers 
o delivery-method 
o event-comment 
o delivery-address 
o locale 

Syntax 

-x "notification-profile={event-identifiers=value 
delivery-method=value event-comment='text' 
delivery-address=value locale=value}" 


For example: 


-x "notification-profile={event-identifiers=class-error 
delivery-method=electronic-mail 

event-comment='fix problem' delivery-address=mary@travel 
locale=C}" 
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Component 


Description 


event- 

identifiers 


Explanation: Specifies the events for which the user 
is to receive messages. 

Value Type: Multiple values. 

Values: A text string up to 4095 characters that 

includes any of the values listed for the attribute 
events-supported of a spooler (pd_att_spooler) or 
supervisor (pd_att_supervisor). 

Default: 

document-aborted-by-printer 

document-aborted-by-server 

document-canceled-at-printer 

job-aborted-by-server 

job-canceled-by-operator 

job-cannot-be-scheduled 

job-completed 

job-discarded 

printer-needs-attention 

printer-needs-operator 

printer-paper-jam 

printer-paper-out 

printer-paper-output-problem 

printer-toner-low 


delivery- 

method 


Explanation: Specifies how the person is to receive 
event messages. 

Value Type: Single value. 

Values: One of the following fixed values: 

Fixed Value Input Synonym 

electronic-mail e-mail, email 

file 

file-add-to 

message 

none 

Default: electronic-mail 


event- 

comment 


Explanation: Supplies textual information that is 
appended to the event message. 

Value Type: Single value. 

Values: A text string up to 4095 characters that 

supplies additional information concerning the event. 
Default: No value. 


delivery- 

address 


Explanation: The address of the person to receive the 
event messages. 

Value Type: Single value. 

Values: A text string that contains the name and node 
of the person that is to receive notification. 

Default: The login of the user that submitted the job 
using the pdpr command. 


locale 


Explanation: Identifies the locale of the user that 
is to receive the messages. 

Value Type: Single value. 

Values: A text string that identifies the locale to 

be used. This is used to determine the language and 
coded character set that the information is to be 
sent in. 

Default: The locale of the user that submitted the 
job with the pdpr command. 
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Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


number-of-documents 


Non Settable 


Identifies the number of documents in the job, including 
resource documents such as fonts. 


Single value. 


An integer from 1 to 2147483647. Set by HPDPS. 


No default. 


Description 


object-class 


Non Settable 


Identifies the object class to which this object belongs. 


Single value. 


The value of this attribute is job. 


job 


Description 


octets-completed 


Non Settable 


Reports the number of octets (bytes) in this job that 
have been printed. 


Single value. 


An integer from 0 to 9223372036854775800. Set by HPDPS. 


No default. 


o This attribute is updated at the completion of each 
result-set. 


Attribute 


Description 
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Name 


Type 


Explanation 


Value Type 


Values 


output-bin-requested 


Non Settable 


Identifies the output-bin specified by the output-bin 
component of the job results-profile attribute. 


Single Value. 


A text string of up to 255 characters that describes the 
output bin, or any of the following fixed values: 


top 

middle 

bottom 

side 

left 

right 

face-up 

face-down 

large 

private 

collator 


Implicitly set by HPDPS. 


Default 


No default. 


Usage | o This attribute is intended for use in the ipmap 

Guidelines | file to convert the output-bin component of the job 

| results-profile attribute to lp options. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


pages-completed 


Non Settable 


Reports the number of pages in this job that have been 
printed. 


Single value. 


An integer from 0 to 2147483647. Set by HPDPS. 


No default. 


o This attribute may or may not be updated depending 
on the requested physical printer. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Description 


physical-printers-requested 


Settable with the pdpr, pdset, or pdmod commands. 


Identifies the physical printers that are being requested 
to print this job. 


Multiple values. 
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Values 

A text string up to 255 characters per physical 
that contains the name of the physical printer. 

printer 

Default 

No default. 


Usage 

Guidelines 

o The job is validated and scheduled against the 

printer attribute printer-name. 

i 

Attribute 

Description 


Name 

previous-job-state 


Input 

Synonym 

previous-state 


Type 

Non Settable 


Explanation 

Identifies the state of the job before the last 
change. 

job state 

Value Type 

Single value. 


Values 

One of the following fixed values set by HPDPS: 



canceled i 

held 

paused 

pending 

pre-processing 

processing 

retained 

terminating 

timed-out 

unknown 


Default 

No default. 


i 

Usage | 

Guidelines | 

1 

Attribute 

Description 


Name 

printer-initial-value-job 


Type 

Non Settable 


Explanation 

Associates an initial-value-job object with the 
printer, which this job was submitted to. 

logical 

Value Type 

Single value. 


Values 

Set by HPDPS. 


Default 

No default. 


Usage 

Guidelines 

o The associated initial-value-job object is used to 

supply values for attributes of jobs submitted to 
this logical printer. These values override server 
defaults but are overridden by job attribute values 
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specified on the command line. 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Description 


printer-locations-requested 


locations-requested 


Settable with the pdpr, pdset, or pdmod commands. 


Identifies the locations where the job is being requested 
to be printed. 


Multiple values. 


Values 


A text string up to 4095 characters that contains the 
physical location of each printer requested. The job 
will be printed on a printer at one of the locations if 
the validation is successful. 


Default 


No default. 


Usage 

Guidelines 


o The job is validated and scheduled against the 
printer attribute printer-locations. 
o Any individual value specified for this attribute can 
select more than one physical printer. For example, 
the printers could all be in the same location, such 
as a printer room. 

o The values for both the job and printer attributes 
are text strings that can include blanks. They must 
match exactly for validation to occur. 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Default 


Description 


printer-models-requested 


models-requested 


Settable with the pdpr, pdset, or pdmod commands. 


Identifies the model ID of the printers requested to 
print the job. 


Multiple values. 


A text string up to 4095 characters per printer that 
contains the printer model to be used to print the job. 


No default. 


Usage 

Guidelines 


o The job is validated and scheduled against the 

printer attribute printer-model. Only one value must 
match for the job to be validated and scheduled, 
o Any individual value specified for this attribute 
can select more than one physical printer. 


Attribute 


Description 
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Name 


Type 


Explanation 


Value Type 


Values 


Default 


printer-mopy-requested 


Settable 


Requests to print multiple copies by using printer's 
internal disk spooling capability. 


Single boolean value. 


Fixed Value 

true 

false 


false. 


Usage | More relevant when submitting multiple copies of large 

Guidelines | jobs, this feature, when supported by physical printer, 
| relieves HPDPS from resubmitting a job to the printer. 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Description 


printer-types-requested 


types-requested 


Settable with the pdpr, pdset, or pdmod commands. 


Identifies the type of the printer to be used for printing 
the job. 


Multiple values 


Any of the following fixed values: 


other 

electrographic-led 

electrographic-laser 

electrographic-other 

impact-moving-head-dot-matrix-9-pin 

impact-moving-head-dot-mat rix-2 4-pin 

impact-moving-head-dot-matrix-other 

impact-moving-head-fully-formed 

impact-band 

impact-other 

inkjet-aqueous 

inkjet-solid 

inkjet-other 

pen 

thermal-transfer 

thermal-sensitive 

thermal-diffusion 

thermal-other 

electro-erosion 

electro-static 

photographic-microfiche 

photographic-imagesetter 

photographic-other 

ion-deposition 

E-beam 
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1 typesetter | 

Default 

No default 


i 

1 

Usage 

Guidelines 

o The job is validated and scheduled against the 

printer attribute printer-types. 


i 

i 

i 

i i 

Attribute 

Description 


i 

1 

Name 

printer-name-requested 


i 

Input 

Synonym 

printer-requested, logical-printer-requested 


i 

i 

Type 

Specifiable with the pdpr command. 


i 

Explanation 

Identifies the logical printer to which this job is to be 
submitted. 

i 

i 

Value Type 

Single value. 


i 

Values 

A text string up to 255 characters that contains the 
of the logical printer. 

name 

i 

i 

Default 

The PDPRINTER environment variable for the client. 


i 

Usage 

Guidelines 

o To move the job to a different logical printer, use 

the pdresubmit command. 

i 

i 

i i 

Attribute 

Description 


i 

■ 

Name 

printers-assigned 


1 

Type 

Non Settable 



Explanation 

Identifies the physical printer to which the job has 
assigned for printing. 

been 


Value Type 

Single value. 



Values 

The global ID of the printer. 



Default 

No default. 



Usage 

Guidelines 

o If the value for the attribute is blank, the job is 

still waiting to be scheduled to a physical printer. 


i i 

Attribute 

Description 


i 

1 

Name 

printers-used 


i 

Type 

Non Settable 


i 

Explanation 

Identifies the physical printers where this job was 
printed. 


i 

i 

Value Type 

Multiple values. 


i 

Values 

Value set by HPDPS. 


i 
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Default 


No default. 


Usage 

Guidelines 


o Normally this value only contains one physical printer 
name. However, if a job had to be restarted on 
another printer because the first printer failed for 
some reason, this value could contain more than one 
physical printer name. 


Attribute 


Name 


Type 


Description 


processing-time 


Non Settable 


Explanation 


Reports the amount of time that the job has been printing 
on the physical printer device. If printing has 
completed, this value is the total amount of time needed 
to print the job. 


Value Type 


Single value. 


Values 


[HH:]MM. Unit is minutes. Set by HPDPS. 


Default 


No default. 


Usage 

Guidelines 


This attribute is updated when a user queries the job 
with the pdls command. The value is calculated by 
comparing the value of the started-printing-time 
attribute of job with the current time. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Description 


queue-assigned 


Non Settable 


Identifies the queue to which the job has been assigned. 


Single value. 


A text string up to 255 characters set by HPDPS that 
contains the name of the queue. 


No default. 


Usage | o If this attribute is blank, the job is not currently 

Guidelines | residing in a queue (it may be in the retained or 

| timed-out state). 


Attribute 


Name 


Type 


Description 


results-profile 


Settable with the pdpr, pdset, or pdmod commands. 


Explanation 


Specifies the delivery method for the hardcopy output, 
and designates who is to receive output and the number of 
copies (per recipient). 
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Value Type 

Multiple values. 

Values 

This is a complex attribute which has the following 
components: 


1. delivery-method 

2. results-set-comment 

3. delivery-address 

4. job-copies 

5. output-bin 

Syntax 

-x M results-profile=\ 

dm value:rc value:da value:jc value:ob value" 


For example: -x ":::2:top" 

Usage 

Guidelines 

o Only the job-copies and output-bin components are 

used by HPDPS. 

Component 

Description 

delivery- 

method 

Explanation: Specifies how the person is to receive 
the job output. 

Value Type: Single value. 

Values: The only value for this component is the 
following fixed value: 
pickup 

Default: pickup 

results- 

set-comment 

Explanation: Supplies a text string that describes 
the results-set value. 

Value Type: Single value. 

Values: A text string up to 4095 characters that 

provides information such as "Please staple this 
document". Or information such as "Please read 
before meeting tomorrow" for the person that is to 
receive the document. This information may be 
printed on start-sheets. 

Default: No default. 

delivery- 

address 

Explanation: The address of the person that is to 
receive the job output. 

Value Type: Single value. 

Values: A text string that contains the address. 

job-copies 

Explanation: Specifies how many copies of the job the 
person is to receive. 

Value Type: Single value. 

Values: An integer (cannot be 0). 

Default: 1 

output-bin 

Values 

Explanation: Specifies the output-bin to be used. 

Value Type: Single value. 

Values: A text string of up to 255 characters that 

describes the output bin, or any of the following 
fixed values: 


top 

middle 

bottom 

side 


HP-UX Release 11.0: October 1997 


-23- 


Section 5-159 















pd_attJob(5) 


pd_attJob(5) 


left 


right 

face-up 

face-down 

large 

private 

collator 

Default: No default. 

The value is validated against the printer attribute 
output-bins-supported. 


Attribute 

Description 


Name 

started-printing-time 


Type 

Non Settable 


Explanation 

Identifies the time the 
printer. 

job was sent to the physical 

Value Type 

Single value. 


Values 

Local time format; USA 

format is M HH:MM:SS mm/dd/yy" 


Set 


by HPDPS. 


Default | No default. 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


submis sion-time 


Non Settable 


Identifies the time the job was added to the queue. 


Single value. 


Local time format; for USA, "HH:MM:SS mm/dd/yy". Set by 
HPDPS. 


Default 


Usage 

Guidelines 


No default. 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Description 


total-job-octets 


job-size 


Non Settable 


The size of the job determined by the sum total of all 
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printable octets in the job. 


Value Type 

Single value. 

Values 

An integer from 0 to 9223372036854775800. Set by HPDPS. 

Default 

No default 

Usage 

Guidelines 

o The server computes this value by totaling the size 

of all printable documents. It is based on the 
number of printable octets and is computed as: 


job-copies X (printable document octet-count X copy-count) 


o The job is validated against the logical printer 

attribute job-size-range-supported. 
o The job is scheduled against the physical printer 

attribute job-size-range-ready. 

i 

Attribute 

Description 

Name 

user-locale 

Type 

Non Settable 

Explanation 

Identifies the language of the information that appears 
on the start, separator, and end sheets printed with the 
job and the messages for the job that are sent to the 
various people. 

Value Type 

Single value. 

Values 

The locale of the job submitter 

Default 

Set from the operation-locale, which is set from the 
user-locale. 

i 

Usage | 

Guidelines | 

1 

Attribute 

Description 

Name 

user-name 

Type 

Non Settable 

Explanation 

Identifies the login ID of the job submitter. 

Value Type 

Single value. 

Values 

A text string that contains the login of the job 
submitter; username@node. 

Default 

No default. 

Usage 

Guidelines 

o Set by HPDPS to username@node. 
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NAME 

pdattjog - list of attributes for an HPDPS log object 


DESCRIPTION 

The foil owing is a list of valid attributes and values for the log object class of the HP Distributed Print Ser¬ 
vice. 

Log objects are automatically created when the server is initialized. These logs contain and keep track of 
such things as error messages and trace messages. These logs cannot be created or deleted, but they can be 
enabled or disabled. A configuration file can be used to set the initial values of attributes for error and 
trace logs when servers are initialized. 

The foil owing are restrictions for log attributes: 

• The log-severity attribute is an attribute only for error logs. 

• The log-trace-groups attribute is an attribute only for trace logs. TP • The values for the 
attributes listed below cannot be set with the pdset command for trace logs. Values can be 
specified using configuration files during server initialization. 

log-address 

log-size 

log-wrap 


Attributes for a Log Object 


Settable Attribute Listing 

i 

Specifiable Attribute Listing 

descriptor 

i 

log-type 

list-of-managers 

i 


log-address 

i 


log-severity 

i 


log-size 

i 


log-trace-groups 

i 


log-wrap 

i 


message 

i 



Table 1-1. 

Log Attributes 



Attribute 

Description 



Name 

associated-server 



Type 

Non Settable 



Explanation 

Indicates the name of the server in which 

resides. 

this 

log 

Value Type 

Single value. 



Values 

The name of the server; set by HPDPS when 
created. 

this 

log is 

Default 

No default. 



i 

Usage | 

Guidelines | 

1 

Attribute 

Description 
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Name | descriptor 

Type 

Settable with the pdset command. 


Explanation 

Provides a description of the object. 


Value Type 

Single value. 


Values 

A text string up to 4095 characters that describes 
log. 

this 

Default 

If trace log: This is the standard trace log. 



If error log: This is the standard error log. 


i 

Usage | 

Guidelines | 

1 

Attribute 

Description 


Name 

enabled 


Type 

Non Settable 


Explanation 

Indicates if the log is enabled. An enabled log writes 
messages to a log file. 

Value Type 

Single value. 


Values 

One of the following fixed values: 



Fixed Value Input Synonym 

true yes 

false no 


Default 

If error log: true 



If trace log: false 


Usage 

Guidelines 

o Implicitly set by the pdenable and pddisable 

commands. 


i 

Attribute 

Description 


Name 

list-of-managers 


Input 

Synonym 

managers 


Type 

Settable with the pdset command. 


Explanation 

Lists the people responsible for the maintenance and 
operation of this log. 

Value Type 

Multiple value. 


Values 

A text string up to 255 characters per person that 
contains the user ID of the person responsible for 
log. 

this 
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1 

Default 

No default 



1 

1 

1 

Usage 

Guidelines 




1 

1 

1 






1 

1 

Attribute 

Description 



1 

1 

1 

Name 

log-address 



1 

1 

1 

Type 

Non Settable 



1 

1 

1 

Explanation 

Specifies the pathname where the log 

resides. 

1 

1 

1 

Value Type 

Single Value 



1 

1 

1 

1 

Values 

A text string up to 4095 characters 
pathname. 

that 

contains the 

1 

1 

1 

1 

Default 

The path defined by the PDBASE environment variable plus 
the ServerName ($PDBASE/ServerName). 

1 

1 

1 

1 

Usage 

Guidelines 

o This attribute defines only the 

path. 


1 

1 

1 






1 

1 

Attribute 

Description 



1 

1 

1 

Name 

log-identifier 



1 

1 

1 

Type 

Non Settable 



1 

1 

1 

Explanation 

Uniquely identifies this log. 



1 

1 

1 

Value Type 

Single Value 



1 

1 

1 

1 

Values 

A text string up to 255 characters set by 
contains the file name of this log. 

HPDPS that 

1 

1 

1 

1 

Default 

If trace log: default_tracelog 

If error log: default_errorlog 



1 

1 

1 

1 

Usage 

Guidelines 




1 

1 

1 






1 

1 

Attribute 

Description 



1 

1 

1 

Name 

log-severity 



1 

1 

1 

Type 

Settable with the pdset command. 



1 

1 

1 

1 

Explanation 

Identifies the severity level of the 
be logged in this error log. 

messages that are to 

1 

1 

1 

Value Type 

Single Value 



1 

1 

Values 

One of the following fixed values: 



1 

1 

1 

1 


error 

warning 

audit 



1 

1 

1 
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debug 

info 


Default 

audit 

Usage 

Guidelines 

o This attribute is only for error logs. 

i 

Attribute 

Description 

Name 

log-size 

Type 

Non Settable for trace logs. 


Settable with the pdset for error logs. 

Explanation 

Specifies how large (kilobytes) a log file is allowed to 
get before the file wraps, or the logging of events is 
halted. Whether a log file wraps or logging is halted is 
determined by the value of the attribute log-wrap. 

Value Type 

Single Value 

Values 

An integer from 1 to 2147483647 (value represents 
kilobytes) 

Default 

If error log: 1024 

If trace log: 8192 

Usage 

Guidelines 

o The value specified in the configuration file, if one 

is specified, will override the default value when 
the server is created. 

o If this attribute is changed, the current log file is 

renamed to error.log.BAK, and a new log file is 
created. 

i 

Attribute 

Description 

Name 

log-trace-groups 

Type 

Settable with the pdset command. 

Explanation 

Specifies the active trace groups for the selective 
tracing of HPDPS component groups. 

Value Type 

Multiple values. 

Values 

Any text string up to 4095 characters that contains trace 
group IDs that are to be traced. 

Default 

???? -1 (Meaning all trace groups) 

Usage 

Guidelines 

o This attribute is only for trace logs and is only to 

be used at the request of an HP Service 

Representative. 

i 

Attribute 

Description 

Name 

log-type 
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Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Non Settable 

Identifies the type of log. 

Single Value 

One of the following fixed values: 

errorlog 

tracelog 

No default. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


log-wrap 


Settable with the pdset command for error logs. 


Specifies whether the log file should wrap or halt when 
the specified value in the log-size attribute is reached. 


Single Value 


One of the following fixed values: 


Fixed Value Input Synonym 

true yes 

false no 


Default | true 


Usage | o 

Guidelines | 


The value specified in the configuration file, if one 
is specified, will override the default value when 
the server is created. 


Attribute 

Description 

Name 

message 

Type 

Settable with the pdset command. 

Explanation 

Provides a message that is associated with this log 
object. 

Value Type 

Single value. 

Values 

A text string up to 4095 characters that contains 
information about this log. 

Default 

No default. 

i 

Usage | 

Guidelines | 
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Attribute | Description 

Name 

object-class 


Type 

Non Settable 


Explanation 

Identifies the object class 

to which this object belongs. 

Value Type 

Single value. 


Values 

The value of this attribute 

is log. 

Default 

log 


i 

Usage | 

Guidelines | 
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NAME 

pd_att_log_ptr - list of attributes for an HP DPS logical printer object 

DESCRIPTION 

The following is a list of valid attributes and values for the logical printer object class of HP Distributed 
Print Services. 

Logical printers are used for job routing, defaulting, and job validation. If a logical printer attribute does 
not have a value, then the corresponding attribute for the physical printer is used. The default for most 
logical printer attributes is 'No value'. This means that the logical printer accepts any valid valuefor those 
attributes. 


Attributes for a Logical Printer Object 


| Settable Attribute Listing 



associated-queue 

authorize-jobs 

character-sets-supported 

content-orientations-supported 

descriptor 

document-attributes-supported 
document-formats-supported 
document-types-supported 
end-messages-supported 
fonts-supported 
input-trays-supported 
interface-program-methods- 
supported 

job-attributes-supported 
job-finishings-supported 
job-sheets-supported 
job-size-range-supported 
list-of-managers 
maximum-copies-supported 
media-supported 
message 

notification-profile 

numbers-up-supported 

page-select-supported 

pd-gway-foreign-host 

pd-gway-foreign-printer 

plexes-supported 

print-qualities-supported 

printer-resolutions-supported 

printer-initial-value-document 

printer-initial-value-job 

printer-locations 

printer-model 

printer-mopy-supported 

sides-supported 

start-message-supported 


Specifiable Attribute Listing 


printer-realization 



Table 1-1. Logical Printer Attributes 


Attribute 


Description 


associated-queue 


Settable with the pdcreate or pdset commands. 
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Explanation 


Identifies the queue associated with this printer. All 
jobs submitted to this logical printer will be sent to 
the queue specified by this attribute. 


Value Type 


Single value. 


Values 


A text string up to 255 characters that contains this 
global ID of the queue. 


Default 


No default. 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Description 


associated-server 


Non Settable 


Indicates the name of the spooler in which this printer 
resides. 


Value Type | Single value. 


Values | A text string up to 255 characters that contains the name 

| of the server. Set from the argument 

| (ServerName:PrinterName) of the pdcreate command when 
| this logical printer was created. 


Default 


No default. 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


authorize-jobs 


Settable with the pdcreate or pdset commands. 


Identifies if the person submitting the job is required 
to be authorized to submit a job to this logical printer. 


Single value. 


One of the following fixed values: 


Fixed Value Input Synonym 

true yes 

false no 


Default 


false 


Usage 

Guidelines 


When the spooler security level is medium the 
following rules apply when the value for this 
attribute is: 

True The login ID of the job submitter is used 

to check if the person has "read" authority 
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on this printer. If the person does have 
"read" authority, the job is authorized. 
False The job is automatically authorized. 

Note: Security level of medium is the only supported 

level. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


character-sets-supported 


Settable with pdcreate or pdset commands. 


Identifies the character set encodings supported by this 
printer. 


Multiple values. 


Any of the following fixed values: 


iso-ucs-2-level2 

other 

ascii 

iso-latinl 

iso-latin2 

iso-latin3 

iso-latin4 

iso-latin-cyrillic 

iso-latin-arabic 

iso-latin-greek 

iso-latin-hebrew 

iso-latin5 

iso-latin6 

iso-text-communication 
half-width-katakana 
jis-encoding 
shift-jis 

euc-packed-format-japanese 

euc-fixed-width-japanese 

iso-reg4-united-kingdom 

iso-regll-swedish-for-names 

iso-regl5-italian 

iso-regl7-spanish 

iso-reg21-german 

iso-reg60-danish-norwegian 

iso-reg69-french 

Unicode 

ucs4 

unicode-ascii 
unicode-latinl 
unicode-ibm-2 03 9 
unicode-ibm-12 61 
unicode-ibm-12 68 
Unicode-ibm-1276 
unicode-ibm-12 64 
unicode-ibm-1265 
windows30-latinl 
windows31-latinl 
windows31-latin2 
windows31-latin5 
hp-roman8 
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adobe-standard-encoding 

ventura-us 

ventura-international 

dec-mcs 

pc-page-850-multilingual 

pc-page-852-latin2 

pc8-page-437-us 

pc8-danish-norwegian 

pc-page-862-latin-hebrew 

pc8-turkish 

ibm-symbols 

ibm-thai 

hp-legal 

hp-pifont 

hp-math8 

hp-ps-math 

hp-desktop 

ventura-math 

microsoft-publishing 

windows31j 

gb-2312 

big5 

cns 

ksc-5601 

cede 


Default 

No default. 

Usage 

Guidelines 

o The document attribute default-character-set is 

compared to this attribute for scheduling and 
validation. 

i 

Attribute 

Description 

Name 

content-orientations-supported 

Input 

Synonym 

orientations-supported 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Identifies the page presentations supported by this 
logical printer. 

Value Type 

Multiple values. 

Values 

Any of the following fixed values: 


landscape 

portrait 

reverse-portrait 

reverse-landscape 

Default 

No value. 

Usage 

Guidelines 

o The document attribute content-orientation is 

compared to this attribute for validation. 

i 

Attribute 

Description 
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Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


descriptor 


Settable with the pdcreate or pdset commands. 


A textual description of this logical printer. 


Single value. 


A text string up to 4095 characters that contains a 
description of this logical printer. 


No default. 


Description 


document-attributes-supported 


Settable with the pdcreate or pdset commands. 


Identifies the document attributes supported by this 
logical printer. This attribute is checked during 
validation to allow jobs whose documents have these 
attributes to be sent to this logical printer. 


Multiple values. 


Any valid document attributes listed in 
pd_att_document(5). 


No default 


Description 


document-formats-supported 


Settable with the pdcreate or pdset commands. 


Identifies the document formats supported by this logical 
printer. 


Multiple values. 


Any of the following fixed values: 


Fixed Value 

ascii 

pci 

hpgl 

Pjl 

postscript 

ipds 

ppds 

escapep 


Input Synonym 

hppcl 

hp-pcl 

hp-gl 

ps 
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epson 

ddif 

interpress 

iso-6429 

line-data 

modca 

regis 

scs 

spdl 

tek4014 

pds 

igp 

codev 

dsc-dse 

wps 

ln03 

ccitt 

quic 

cpap 

dec-ppl 

simple-text 

npap 

doc 

impress 

pinwriter 

npdl 

nec201pl 

automatic 

pages 

lips 

tiff 

diagnostic 

capsl 

excl 

lcds 

xes 

passthru 


Default 


No values. 


Usage | o The document attribute document-format is compared to 

Guidelines | this attribute for validation. 


Attribute 

Description 


Name 

document-types-supported 


Type 

Settable with the pdcreate 

or pdset commands. 

Explanation 

Identifies the types of documents that are supported by 
this logical printer. 

Value Type 

Multiple values. 


Values 

Any of the following fixed 

values: 


file-reference 

printable 


Default 

No values. 
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| Usage | o The document attribute document-type is compared to | 

| Guidelines | this attribute for validation. | 


1 

1 

Attribute | 

Description 


Name | 

enabled 


Type | 

Non Settable 


Explanation| 

Indicates if 
accept print 

this logical printer is enabled and can 
jobs. 

Value Type | 

Single value 



| Values | One of the following fixed values: 


| | Fixed Value Input Synonym 

| | true yes 

| | false no 

I I 

| | Implicitly set and reset by the pdenable and pddisable 

| | commands. 


| Default | false 


| Usage | 

| Guidelines | 


| Attribute | Description 


| Name | end-message-supported 



| Type | Settable with the pdcreate or pdset commands. 


| Explanation! Indicates whether jobs submitted to this logical printer 
| | can specify an end message. 

| Value Type | Single value. 

| Values | One of the following fixed values: 



Fixed Value 

true 

false 

Input Synonym 
yes 

no 

Default 

No value. 


Usage 

Guidelines 

o The job attribute job-end-message is compared to this 

attribute for validation. 

i 

Attribute 

Description 


Name 

fonts-supported 


Type 

Settable with the 
printer attribute 

pdcreate or pdset commands, or the 
file. 

1 

Usage | 
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Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Identifies the fonts supported by this printer. 


Multiple values 


Any text string that contains the font names supported by 
this printer. 


No default. 


o The document attribute default-font is compared to 
this attribute for scheduling and validation. 


Attribute 


Description 


Name 


Type 


Explanation 


Value Type 


Values 


input-trays-supported 


Settable with the pdcreate or pdset commands. 


Specifies the types of input trays that are supported by 
this logical printer. 


Multiple values. 


A text string of up to 255 characters that describes the 
input tray, or one of the following fixed values: 


top 

middle 

bottom 

envelope 

manual 

large-capacity 

main 

side 


Default 


No value. 


Usage | o The document attribute input-tray-select and 

Guidelines | default-input-tray are compared to this attribute 

| for validation. 


Attribute 

Description 


Name 

interface-program-methods-supported 


Type 

Settable with the pdcreate, pdset commands, 
attribute file. 

or printer 

Explanation 

Identifies the interface program invocation 
supported by this printer. 

methods 

Value Type 

Single value. 


Values 

Any of the following fixed values: 



hpdps 

ip 


HP-UX Release 11.0: October 1997 


-8- 


Section 5-175 

























pdattlogptr (5) 


pdattlogptr (5) 


Default 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


No default. 


o The job attribute interface-program-method is compared 
to this attribute for validation. 


Description 


job-attributes-supported 


Settable with the pdcreate or pdset commands. 


Identifies the job attributes supported by this printer. 


Multiple values. 


Any valid job attributes listed in pd_att_job(5). 


No value. 


Description 


job-finishings-supported 


Settable 


Indicates the finishing method supported by this printer. 


Single value. 


staple 

top-left-staple 


No default. 


To verify if a printer is capable of performing a 
finishing process on a print job. 


Description 


job-sheets-supported 


Settable with the pdcreate or pdset commands. 


Identifies the auxiliary-sheet-package values supported 
this printer. 


Multiple values. 


Any of the following fixed values: 
none 

job-separators 

job-set-start 

job-set-end 

job-set-wrap 

job-set-start-copies-separate 
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job-set-end-copies-separate 
job-set-wrap-copies-separate 
job-copy-start 
j ob-copy-end 
j ob-copy-wrap 


Default 


No value. 


Usage 

Guidelines 


o The job attribute job-sheets is compared to this 
attribute for validation. 

o The auxiliary-sheet-package object is not implemented. 
These values are used to select the auxiliary sheets. 


Attribute 

Description 


Name 

job-size-range-supported 

Type 

Settable with the 

pdcreate or pdset commands. 

Explanation 

Defines the range 
accept. 

of job sizes (in bytes) the printer can 

Value Type 

Single value. 


Values 

This is a complex 
components: 

attribute with the following 


lower limit 
upper limit 


Syntax 


Two integers separated by a colon; the value of the 
integers can be from 0 to 9223372036854775800 


lower limit:upper limit 


For example: 0:1000000000 


Usage 

Guidelines 


The job attribute total-job-octets is compared to 
this attribute for validation. 


Component 


Description 


lower 

limit 


Explanation: Provides the lower limit of the job size 

range. 

Value Type: Single value. 

Values: 

o The unit is octets (bytes). 

o The first integer identifies the lower limit and 
must be less than or equal to the second integer 
(the upper limit). 

o If only the lower limit is supplied, the upper 
limit defaults to 9223372036854775800 


Default: No value. 


upper 

limit 


Explanation: Provides the lower limit of the job size 
range. 

Value Type: Single value. 

Values: 

o The unit is octets (bytes). 

o The first integer identifies the lower limit and 
must be less than or equal to the second integer 
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(the upper limit). 

o If only the upper limit is supplied, the lower 
limit defaults to 0. 

Default: No value. 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


list-of-managers 


managers 


Settable with the pdcreate or pdset command. 


Identifies the people responsible for the maintenance and 
operation of this logical printer. 


Multiple values. 


A text string up to 255 characters per person that 
contains the name or user ID of the person responsible 
for this logical printer. 


No values. 


Description 


maximum-copies-supported 


Settable with the pdcreate or pdset 


Indicates the number of document copies, in a single 
print job, allowed by this logical printer. 


Single value. 


An integer from 1 to 2147483647. 


No value. 


o If this attribute value is blank, there is no limit 
to the number of document copies. 
o The document attribute copy-count is compared to this 
attribute for validation. 


Description 


media-supported 


Settable with the pdcreate or pdset 


Identifies the types of media supported by this logical 
printer. 


Multiple values. 


A text string up to 255 characters per item that contains 
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1 

1 

a unique name or any of the following fixed values: 



1 

1 

iso-a4-white 



1 

iso-a4-colored 



1 

iso-a4-transparent 



1 

iso-a3-white 



1 

iso-a3-colored 



1 

iso-a5-white 



1 

iso-a5-colored 



1 

iso-b4-white 



1 

iso-b4-colored 



1 

iso-b5-white 



1 

iso-b5-colored 



1 

na-letter-white 



1 

na-letter-colored 



1 

na-letter-transparent 



1 

na-legal-white 



1 

na-legal-colored 



1 

iso-b5-envelope 



1 

iso-b4-envelope 



1 

iso-c4-envelope 



1 

iso-c5-envelope 



1 

designated-long-envelope 



1 

na-10xl3-envelope 



1 

na-9xl2-envelope 



1 

monarch-envelope 



1 

na-number-10-envelope 



1 

na-7x9-envelope 



1 

na-9x11-envelope 



1 

na-10x14-envelope 



1 

na-number-9-envelope 



1 

na-6x9-envelope 



1 

na-10xl5-envelope 



1 

jis-b4-white 



1 

jis-b4-colored 



1 

jis-b5-white 



1 

jis-b5-colored 



1 

executive 



1 

folio 



1 

invoice 



1 

ledger 



1 

quarto 



1 

iso-aO-white 



1 

iso-al-white 



1 

iso-a2-white 



1 

iso-a6-white 



1 

iso-a7-white 



1 

iso-a8-white 



1 

iso-a9-white 



1 

iso-al0-white 



1 

iso-bl0-white 



1 

iso-bO-white 



1 

iso-bl-white 



1 

iso-b2-white 



1 

iso-b3-white 



1 

iso-b6-white 



1 

iso-b7-white 



1 

iso-b8-white 



1 

iso-b9-white 



1 

iso-bl0-white 



1 

jis-bO-white 



1 

jis-bl-white 
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jis-b2-white 

jis-b3-white 

jis-b6-white 

jis-b7-white 

jis-b8-white 

jis-b9-white 

jis-bl0-white 

a 

b 

c 

d 

e 


1 

Default 

No value. 

1 

1 

1 

Usage 

Guidelines 

o The document attribute default-medium is compared to 

this attribute. 

1 

1 

1 




1 

1 

Attribute 

Description 

1 

1 

1 

Name 

message 

1 

1 

1 

Type 

Settable with the pdcreate or pdset command. 

1 

1 

1 

Explanation 

Information associated with this logical printer. 

1 

1 

1 

Value Type 

Single value. 

1 

1 

1 

1 

Values 

A text string up to 4095 characters that contains 
information about this logical printer. 

1 

1 

1 

Default 

No default. 

1 

1 

1 

Usage 

Guidelines 


1 

1 

1 




1 

1 

Attribute 

Description 

1 

1 

1 

Name 

notification-profile 

1 

1 

1 

Type 

Settable with the pdcreate or pdset command. 

1 

1 

1 

1 

1 

Explanation 

Designates which persons are to be notified of specific 
events related to this logical printer, and how they are 
to be notified. 

1 

1 

1 

1 

Value Type 

Multiple values. 

1 

1 

1 

Values 

This is a complex attribute, which has the following 
components: 

1 

1 

1 

1 

1 

1 

1 


o event-identifiers 
o delivery-method 
o event-comment 
o delivery-address 
o locale 

1 

1 

1 

1 

1 

1 

1 

1 

Syntax 

-x "notification-profile={event-identifiers=value 
delivery-method=value event-comment='text' 
delivery-address=value locale=value}" 

1 

1 

1 
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For example: 

-x "notification-profile={event-identifiers= 

class-physical-printer-status 

delivery-method=electronic-mail 

event-comment='Its still going' 

delivery-address=jeffQttank 

locale=C}" 


Component 


Description 


event- | Explanation: Specifies which events the person is to 

identifiers| receive messages about. 

| Value Type: Multiple values. 

| Values: Any of the values listed for spooler attribute 
| events-supported in pd_att_spooler(5). 

| Default: 

| o object-deleted 

| o object-cleaned 


delivery- 

method 


Explanation: Specifies how the person is to receive 
event messages. 

Value Type: Single value. 

Values: One of the following fixed values: 

Fixed Value Input Synonym 

electronic-mail e-mail, email 

message 
none 

Default: electronic-mail 


event- | Explanation: A text string that provides a comment 

comment | that is appended to the event message. 

| Value Type: Single value. 

| Values: A text string up to 4095 characters that 
| contains the comment. 

| Default: No value. 


delivery- | Explanation: The address of the person that is to 
address | receive event messages. 

| Value Type: Single value. 

| Values: The name and node of the person that is to 
| receive messages concerning the operation of this 

| logical printer. 

| Default: The login of the user that created this 
| logical printer with the pdcreate command. 


locale 


Explanation: Defines the locale of the person to 
receive the messages. The locale is used to 
determine the language that the messages are 
transmitted in. 

Value Type: Single value. 

Values: The locale identification. 

Default: The locale of the person that created this 
logical printer with the pdcreate command. 


Attribute 


Name 


Type 


Description 


numbers-up-supported 


Settable with the pdcreate or pdset commands. 
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Explanation 

Identifies the number-up values supported by this printer. 
See the explanation of document attribute number-up in 
pd_att_document(5) for more information on number-up 
values. 

Value Type 

Multiple values. 

Values 

Any of the following fixed values: 

0 

1 

2 

4 

Default 

No default. 

Usage 

Guidelines 

o The document attribute number-up is compared to this 

attribute for validation. 

i 

Attribute 

Description 

Name 

object-class 

Type 

Non Settable. 

Explanation 

Identifies the object class to which this object belongs. 

Value Type 

Single value. 

Values 

The value of this attribute must be printer. 

Default 

printer 

i 

Usage | 

Guidelines | 

1 

Attribute 

Description 

Name 

output-bins-supported 

Type 

Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 

Usage 

Values vary by printer model. 

Explanation 

Identifies the output bins supported by this printer. 

Value Type 

Multiple values. 

Values 

A text string of up to 255 characters that describes the 
output bin, or any of the following fixed values: 


top 

middle 

bottom 

side 

left 

right 

face-up 
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face-down 

large 

private 

collator 


Default 


No default 


Usage | o The job attribute results-profile component output-bin 

Guidelines | is compared to this attribute for validation. 


Attribute 


Name 


Type 


Usage 


Description 


page-select-supported 


Settable with the pdcreate or pdset commands, 
printer attribute file. 


Values vary by printer model. 


or by the 


Explanation 


Identifies the types of page identifiers supported by this 
printer, either numeric or alphanumeric string, or both. 
Only the numeric type is currently supported. This 
attribute specifies the acceptable values that may be 
given for document attribute page-select; see 
pd_att_document(5) for more information. 


Value Type 


Multiple values. 


Values 


Any of the following fixed values: 


numeric 


Default 


No default 


Usage | o The document attribute page-select is compared to 

Guidelines | this attribute for validation. 


Attribute 


Name 


Type 


Description 


pd-gway-foreign-host 


Settable with the pdcreate or pdset commands. 


Explanation 


Identifies the remote host associated with an HPDPS 
Gateway printer. Requests for the HPDPS Gateway 
printer will query the HPDPS on this host for information 
on how to contact the remote server. 


Value 


Value 


Type 


Single valued. 


A text string of up to 255 characters that contains the 
name of the remote host. 


Default 


No default. 


Usage 

Guidelines 


o This attribute is defined only for HPDPS Gateway 
printers. 

o This attribute names a host that runs a basicdsd 
server for the remote environment. If the remote 
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logical printer belongs to an NFS diskless cluster, 
this attribute must name the cluster server host. 
Otherwise, if the remote printer belongs to a DCE 
Extended Environment then any host in the DCE cell 
(that is not a diskless client) may be chosen. 
Otherwise, the name of the standalone host that 
defines the remote logical printer must be chosen. 


1 

1 

Attribute 

Description 

1 

Name 

pd-gway-foreign-printer 

1 

Type 

Settable with the pdcreate or pdset commands. 

1 

1 

1 

1 

Explanation 

Identifies the remote logical printer associated with an 
HPDPS Gateway printer. Requests for the HPDPS Gateway 
printer will be sent to this logical printer in the 
foreign environment. 

1 

Value Type 

Single valued. 

1 

1 

1 

Value 

A text string of up to 255 characters that contains the 
name of the remote logical printer in the foreign 
environment. 

1 

Default 

No default. 

1 

1 

Usage 

Guidelines 

o This attribute is defined only for HPDPS Gateway 

printers. 

o The value is a logical printer name that must be 

recognized by the HPDPS on the remote host given by 
attribute pd-gway-foreign-host. 




1 

Attribute 

Description 

1 

Name 

plexes-supported 

1 

Type 

Settable with the pdcreate or pdset commands. 

1 

1 

1 

1 

1 

Explanation 

Identifies the plexes supported by this printer. Plex 
indicates whether the page images of the output document 
are conditioned for eventual one-sided or two-sided 
printing, and the relative orientation of consecutive 
pages. 

1 

Value Type 

Multiple values. 

1 

Values 

Any of the following fixed values: 



simplex (single sided) 

duplex (double sided) 

tumble (double sided, every other page upside-down) 


Default 

i 

No 

default. 



Usage 

i 

o 

The document attribute plex is compared to 

this 


Guidelines 

i 

i 

o 

attribute for validation. 

HPDPS defaults "sides=2" when plex=duplex. 

HPDPS 

does | 


not currently perform any other conditioning when 
plex=duplex. 
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Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


printer-mopy-supported 


Settable 


Indicates if printer is capable of printing multiple 
copies by spooling a job in internal storage. 


Single boolean value. 


true, or false. 


No default. 


To verify if multiple copies can be printed by submitting 
a job to the printer once. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


printer-resolutions-supported 


Settable with the pdcreate or pdset commands. 


Identifies the resolutions supported by this printer. 


Multiple values. 


This is a complex attribute with the following components: 

o An optional object identifier with one of the 
following fixed values: 


highest 

lowest 

medium 


o An integer from 0 to 2147483647. 


Syntax 


[object identifier:]integer value 


For example: highest:600, or 300 


Component 


Description 


1st 

component 


Explanation: If given, the 1st component specifies an 
object identifier that is associated with the 
resolution value given in the 2nd component. 

This component is optional. 


If a job specifies the value of the default-printer- 
resolution attribute to be one of these object 
identifiers (highest/lowest/medium), this component 
gives the mapping of that object identifier to the 
actual resolution specified by the 2nd component. 


2nd 

component 


Explanation: Actual resolutions in dots per inch supported 
by this printer. 
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Default 

none 

Usage 

Guidelines 

o The document attribute default-printer-resolution is 

compared to this attribute for validation. 

i 

Attribute 

Description 

Name 

printer-associated-printers 

Type 

Non Settable 

Explanation 

Identifies the physical printers associated with this 
logical printer. 

Value Type 

Multiple values. 

Values 

A text string up to 255 characters per physical printer 
that contains the ID of an associated physical printer. 
Implicitly set along with the queue attribute 
physical-printers-assigned of the queue associated with 
this logical printer when the physical printer registers. 

Default 

No value. 

i 

Usage | 

Guidelines | 

1 

Attribute 

Description 

Name 

printer-initial-value-document 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Associates an initial-value-document object with this 
logical printer. 

Value Type 

Single value. 

Values 

A text string up to 255 characters that contains the name 
of the initial-value-document object. 

Default 

No default. 

Usage 

Guidelines 

o The associated initial-value-document object is used 

to supply values for attributes for documents 
submitted to this logical printer. These values 
override server defaults but are overridden by 
document attribute values specified on the command 
line. 

Attribute 

Description 

Name 

printer-initial-value-job 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Associates an initial-value-job object with this logical 
printer. 
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Value Type 


Values 


Default 


Single value. 


A text string up to 255 characters that contains the name 
of the initial-value-job object. 


No default. 


Usage 

Guidelines 


o The associated initial-value-job object is used to 
supply values for attributes of jobs submitted to 
this logical printer. These values override server 
defaults but are overridden by job attribute values 
specified on the command line. 


Attribute 

Description 


Name 

| printer-locations 


Input 

Synonym 

| locations 


Type 

Settable with the pdcreate or pdset commands 


Explanation 

| Identifies the locations of physical printer 
| the areas they service, that are allowed for 
submitted through this logical printer. 

devices, 
jobs 

Value Type 

| Multiple values. 



or 


Values 


A text string up to 4095 characters per physical printer 
that contains the actual physical location of a physical 
printer device. 


Default 


No default. 


Usage | o The job attribute printer-locations-requested is 

Guidelines | compared to this attribute for validation. 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Default 


Description 


printer-model 


model 


Settable with the pdcreate or pdset commands. 


Identifies the model ID of a physical printer device that 
can accept jobs submitted through this logical printer. 


Single value. 


A text string up to 4095 characters per physical printer 
that contains the make and model of a physical printer 
device. 


No default. 


Usage | o The job attribute printer-models-requested is 

Guidelines | compared to this attribute for validation. 
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1 

Attribute 

Description 

1 

1 

Name 

printer-name 

1 

1 

1 

Input 

Synonym 

printer, logical-printer 

1 

1 

1 

Type 

Non Settable 

1 

1 

Explanation 

Identifies this logical printer object. 

1 

1 

Value Type 

Single value. 

1 

1 

1 

1 

1 

Values 

A text string up to 255 characters that contains the name 
of this logical printer. Implicitly set from the 
argument (ServerName:PrinterName) specified by the 
pdcreate command used to create this logical printer. 

1 

1 

1 

1 

1 

Default 

No default. 

1 

1 

1 

1 

Usage 

Guidelines 

o The job attribute physical-printer-requested is 

compared to this attribute for validation, 
o The name must be unique within the DCE cell. 

1 

1 

1 

1 




1 

1 

Attribute 

Description 

1 

1 

1 

Name 

printer-realization 

1 

1 

1 

Type 

Specifiable with the pdcreate command. 

1 

1 

1 

1 

Explanation 

Indicates whether the printer has been designated as a 
physical or a logical printer. 

1 

1 

1 

Value Type 

Single value. 

1 

1 

Values 

One of the following values: 

1 

1 

1 


logical 

physical 

1 

1 

1 


Must be logical for printers created in a spooler server. 

1 

1 

Default 

logical 

1 

1 

1 

Usage 

Guidelines 


1 

1 

1 




1 

1 

Attribute 

Description 

1 

1 

1 

Name 

printers-ready 

1 

1 

1 

Type 

Non Settable 

1 

1 

1 

1 

1 

1 

Explanation 

Identifies the physical printers associated with this 
logical printer that are ready to process a job. 

Implicitly set when a registered physical printer is 
identified as ready. 

1 

1 

1 

1 

1 

Value Type 

Multiple values. 

1 
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Values 

A text string up to 255 characters per physical printer 
that contains the ID of a physical printer that is 
ready. 

Default 

No value. 

Usage 

Guidelines 

o A ready physical printer is one that is enabled and 

whose state is either idle, connecting-to-printer, or 
printing. 

i 

Attribute 

Description 

Name 

sides-supported 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Identifies whether this logical printer supports printing 
on one or two or both sides of the media. 

Value Type 

Multiple values. 

Values 

An integer of 1 or 2. To support both single-sided and 
double-sided printing, use both value 1 and value 2 as 
separate values for this multiple-valued attribute. 

Default 

No value. 

Usage 

Guidelines 

o The document attribute sides is compared to this 

attribute for validation. 

i 

Attribute 

Description 

Name 

start-message-supported 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Indicates whether jobs submitted through this logical 
printer can specify a start message. 

Value Type 

Single value. 

Values 

One of the following fixed values: 


Fixed Value Input Synonym 

true yes 

false no 

Default 

No value. 

Usage 

Guidelines 

o The job attribute job-start-message is compared to 

this attribute for validation. 
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NAME 

pd_att_phy_ptr - list of attributes for an HPDPS physical printer object 

DESCRIPTION 

The following is a list of valid attributes and values for the physical printer object class of HP Distributed 
Print Services. 

1. Physical printers are used for job validation and scheduling. 

2. The physical printer attributes xxx-supported are used for job validation. Both the xxx-ready 
and the xxx-supported attributes are used for job scheduling. 

3. An error is issued if a xxx-ready attribute is updated with a value that is not currently assigned 
to the corresponding xxx-supported attribute. 

4. Physical printers have different attribute sets based on the printer models. 

5. Some of physical printer attributes can be specified in the printer attribute file for the printer. 
Note that xxx-ready attributes may not be described in the printer attribute file. 


Attributes for a Physical Printer Object 


Settable Attribute Listing 


associated-queue 
attachment-types-supported 
character-sets-supported 
content-orientations-supported 
descriptor 

document-attributes-supported 
document-formats-supported 
document-types-supported 
end-message-supported 
fonts-supported 
input-trays-ready 
input-trays-supported 
interface-program-methods- 
supported 

job-attributes-supported 
j ob-bat che s-ready 
job-finishings-ready 
job-finishings-supported 
job-sheets-supported 
job-size-range-ready 
job-size-range-supported 
list-of-managers 
maximum-copies-supported 
media-ready 
media-supported 
message 

notification-profile 

notify-operator 

numbers-up-supported 

page-select-supported 

plexes-supported 

printer-community-name 

printer-tcpip-internet-address 

printer-tcpip-port-number 

printer-locations 

printer-mopy-ready 

printer-mopy-supported 

printer-pass-through 

printer-register-threshold 

printer-resolutions-supported 

printer-resource-context- 


Specifiable Attribute Listing 


attachment-type 

device-name 

print-queue-name 

printer-realization 

printer-model 
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printer 

i 

printer-timeout-period 

i 

printer-types 

i 

sides-supported 

i 

start-message-supported 

i 


Table 1-1. Physical Printer Attributes 


Attribute 

Description 

Name 

associated-queue 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Identifies the queue that this physical printer receives 
jobs from for printing. 

Value Type 

Single value. 

Values 

A text string up to 255 that contains the ID of the 
queue. The ID cannot contain the cell name. 

Default 

No default. 

Usage 

Guidelines 

o The value for this attribute is the name of a queue 

object. The associated queue must exist and be in 
communication with the printer before the physical 
printer can be enabled. 

i 

Attribute 

Description 

Name 

associated-server 

Type 

Non Settable 

Explanation 

Identifies the name of the supervisor in which this 
physical printer resides. 

Value Type 

Single value. 

Values 

A text string up to 255 characters that contains the name 
of this physical printer. Implicitly set from the 
argument (ServerName:PrinterName) of the pdcreate command 
used to create this physical printer. 

Default 

No default. 

i 

Usage | 

Guidelines | 

1 

Attribute 

Description 

Name 

attachment-type 

Type 

Specifiable with the pdcreate command. 
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Usage 


Values vary by printer model. 


Explanation 


Identifies how the physical printer device represented by 
this physical printer is attached to the supervisor and 
how the supervisor is to communicate with the physical 
printer device. 


Value Type 


Single value. 


Values 


One of the following fixed values: 


tcpip 


tcpip-bsd 


serial 


parallel 


lp-spool-hp 


supervisor will communicate with 
this printer via the TCP/IP network 
with TCP port 910X protocol. The 
printer must be a network peripheral. 
This protocol is supported by some HP 
JetDirect products. 

supervisor will communicate with 
this printer via the TCP/IP network 
with the BSD (lpd) protocol. The 
printer must be a network peripheral. 
This protocol is supported by some HP 
JetDirect products. 

supervisor will communicate with 
this printer via the serial interface. 

supervisor will communicate with 
this printer via the parallel 
interface. 

supervisor will communicate with 
this printer using the lp spooler 
protocol for an HP-UX system. The 
printer must belong to an lp spooler 
on an HP-UX host. 


lp-spool-bsd supervisor will communicate with 

this printer using the BSD (lpd) 
spooler protocol. The printer must 
belong to an lp/lpr spooler on a non- 
HP-UX host. 


Default 

i 

No 

default. 

Usage 

i 

o 

Must be set with the pdcreate command at the time of 

Guidelines 

i 


creation. 


i 

o 

This attribute is validated against the printer 


attachment-types-supported attribute. 


Attribute 


Name 


Type 


Usage 


Explanation 


Description 


attachment-types-supported 


Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 


Values vary by printer model. 


Identifies the attachment types supported by the physical 


Section 5-192 


-3- 


HP-UX Release 11.0: October 1997 
















pdattphyptr (5) 


pdattphyptr (5) 


printer. 


Value 


Values 


Type 


Multiple value. 


Any of the following fixed values: 


top ip 


tcpip-bsd 


serial 


parallel 


lp-spool-hp 


lp-spool-bsd 


supervisor will communicate with 
this printer via the TCP/IP network 
with TCP port 910X protocol. The 
printer must be a network peripheral. 
This protocol is supported by some HP 
JetDirect products. 

supervisor will communicate with 
this printer via the TCP/IP network 
with the BSD (lpd) protocol. The 
printer must be a network peripheral. 
This protocol is supported by some HP 
JetDirect products. 

supervisor will communicate with 
this printer via the serial interface. 

supervisor will communicate with 
this printer via the parallel 
interface. 

supervisor will communicate with 
this printer using the lp spooler 
protocol for an HP-UX system. The 
printer must belong to an lp spooler 
on an HP-UX host. 

supervisor will communicate with 
this printer using the BSD (lpd) 
spooler protocol. The printer must 
belong to an lp/lpr spooler on a non- 
HP-UX host. 


Default 


No default. 


Usage | o The printer attribute attachment-type is compared to 

Guidelines | this attribute for validation. 


Attribute 

Description 


Name 

cancel-individual-document-supported 


Type 

Non Settable 


Explanation 

Indicates whether the printer is capable of 
single document within a multiple-document 

cancelling a 
job. 

Value Type 

Single Value 


Values 

One of the following fixed values: 



Fixed Value Input Synonym 

true yes 

false no 
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Default 


Usage 

Guidelines 


false 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Values 


Description 


character-sets-supported 


Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 


Values vary printer model. 


Identifies the character set encodings supported by this 
printer. 


Multiple values. 


Any of the following fixed values: 


iso-ucs-2-level2 

other 

ascii 

iso-latinl 

iso-latin2 

iso-latin3 

iso-latin4 

iso-latin-cyrillic 

iso-latin-arabic 

iso-latin-greek 

iso-latin-hebrew 

iso-latin5 

iso-latin6 

iso-text-communication 
half-width-katakana 
jis-encoding 
shift-jis 

euc-packed-format-japanese 

euc-fixed-width-japanese 

iso-reg4-united-kingdom 

iso-regll-swedish-for-names 

iso-regl5-italian 

iso-regl7-spanish 

iso-reg21-german 

iso-reg60-danish-norwegian 

iso-reg69-french 

Unicode 

ucs4 

unicode-ascii 
unicode-latinl 
unicode-ibm-2039 
unicode-ibm-12 61 
unicode-ibm-12 68 
unicode-ibm-1276 
unicode-ibm-12 64 
unicode-ibm-12 65 
windows30-latinl 
windows31-latinl 
windows31-latin2 
windows31-latin5 
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hp-roman8 

adobe-standard-encoding 

ventura-us 

ventura-international 

dec-mcs 

pc-page-850-multilingual 

pc-page-852-latin2 

pc8-page-437-us 

pc8-danish-norwegian 

pc-page-862-latin-hebrew 

pc8-turkish 

ibm-symbols 

ibm-thai 

hp-legal 

hp-pifont 

hp-math8 

hp-ps-math 

hp-desktop 

ventura-math 

microsoft-publishing 

windows31j 

gb-2312 

big5 

cns 

ksc-5601 

cede 


Default 


No default. 


Usage | o The document attribute default-character-set is 

Guidelines | compared to this attribute for scheduling and 

| validation. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


checkpoint-formats-supported 


Non Settable 


Identifies checkpoints supported for paused jobs. 
Multiple values. 

Any of the following fixed values: 

Fixed Value 
dsf-results-profile 

dsf-resuls-profile 


o Used in rescheduling paused jobs. 

o HPDPS currently supports only dsf-results-profile. 
Job can be paused/resumed at results-set boundaries 
only. 


Attribute 


Name 


Input 


Description 


content-orientations-supported 


orientations-supported 
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1 

Synonym 

i 

1 

1 

Type 

1 

Settable with the pdcreate or pdset commands, or by the | 

printer attribute file. | 

1 

Usage 

1 

Values vary by printer model. | 

1 

1 

Explanation 

1 

Identifies the page presentations supported by this | 

printer. | 

1 

Value Type 

1 

Multiple values. | 

1 

Values 

1 

Any of the following fixed values: | 

1 

1 

1 

1 


landscape | 
portrait | 
reverse-landscape | 
reverse-portrait | 

1 

Default 

1 

portrait | 

1 

1 

1 

Usage 

Guidelines 

1 

o The document attribute content-orientation is | 

compared to this attribute for scheduling and | 

validation. | 

1 


1 

1 

1 

Attribute 

1 

Description | 

1 

1 

Name 

1 

descriptor | 

1 

1 

Type 

1 

Settable with the pdcreate or pdset command. | 

1 

1 

Explanation 

1 

A textual description of this physical printer. | 

1 

1 

Value Type 

1 

Single value. | 

1 

1 

1 

Values 

1 

A text string up to 4095 characters that describes this | 

physical printer. | 

1 

Default 

1 

No default. | 

1 

1 

Usage 

Guidelines 

i 

i 

i 

1 


1 

1 

1 

Attribute 

1 

Description | 

1 

1 

Name 

1 

device-name | 

1 

1 

Type 

1 

Specifiable with the pdcreate command. | 

1 

1 

Usage 

1 

1 

1 

1 

1 

Explanation 

1 

Identifies the name of the device special file associated | 
with the communication interface for the printer. | 

1 

Value Type 

1 

Single value. | 

1 

1 

Values 

1 

A text string that identifies the path name of the device | 
associated with the physical printer. | 

1 

Default 

1 

No default. | 
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Usage 


o Must be set with the pdcreate command at the time of 
creation if the attachment-type is serial or parallel. 
Ignored for other attachment-types. 


Attribute 


Name 


Type 


Description 


document-attributes-supported 


Settable with the pdcreate or pdset commands, 
printer attribute file. 


or by the 


Explanation 


Identifies the document attributes supported by this 
physical printer. This attribute is checked during 
validation to allow jobs whose documents have these 
attributes to be sent to this physical printer. 


Value Type 


Multiple values. 


Values 


Any of valid document attributes in pd_att_document(5). 


Default 


No default. 


Usage | o The document attributes are compared to this attribute 

Guidelines | for scheduling and validation. 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Values 


Description 


document-formats-supported 


Settable with the pdcreate and pdset commands, or by the 
printer attribute file. 


Values vary by printer mode. 


Identifies the document formats supported by this 
physical printer. 


Multiple values. 


Any of the following fixed values: 


Fixed Value 

ascii 

pci 

hpgl 

Pjl 

postscript 

ipds 

ppds 

escapep 

epson 

ddif 

interpress 

iso-6429 

line-data 

modca 

regis 

scs 


Input Synonym 

hppcl 

hp-pcl 

hp-gl 

ps 
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spdl 
tek4014 
pds 

igp 

codev 

dsc-dse 

wps 

ln03 

ccitt 

quic 

cpap 

dec-ppl 

simple-text 

npap 

doc 

impress 

pinwriter 

npdl 

nec201pl 

automatic 

pages 

lips 

tiff 

diagnostic 

capsl 

excl 

lcds 

xes 

passthru 


Default 

No default. 

Usage 

Guidelines 

o The document attribute document-format is compared to 

this attribute for scheduling and validation. 

i 

Attribute 

Description 

Name 

document-types-supported 

Type 

Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 

Explanation 

Identifies the types of documents supported by the 
physical printer. 

Value Type 

Multiple values. 

Values 

Any of the following fixed values: 


printable 

Default 

printable 

Usage 

Guidelines 

o The document attribute document-type is compared to 

this attribute for scheduling. 

i 

Attribute 

Description 

Name 

enabled 
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Type 

Non Settable 

Explanation 

Indicates if the printer is enabled and can accept print 
jobs. 

Value Type 

Single value. 

Values 

One of the following fixed values: 


true 

false 


Value is set to false when the printer is disabled with 
the pddisable command. 

Default 

false 

Usage 

Guidelines 

o The queue associated with the printer must exist and 

be in communication with the printer before the 
printer can be enabled. 

i 

Attribute 

Description 

Name 

end-message-supported 

Type 

Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 

Explanation 

Indicates whether the physical printer supports the job 
attribute job-end-message. 

Value Type 

Single value. 

Values 

One of the following fixed values: 


Fixed Value Input Synonym 

true yes 

false no 

Default 

true 

Usage 

Guidelines 

o The job attribute job-end-message is compared to this 

attribute for validation. 

i 

Attribute 

Description 

Name 

fonts-supported 

Type 

Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 

1 

Usage | 

Explanation 

Identifies the fonts supported by this printer. 

Value Type 

Multiple values 

Values 

Any text string that contains the font names supported by 
this printer. 
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Default 


No default. 


Usage | o The document attribute default-font is compared to 

Guidelines | this attribute for scheduling and validation. 


Attribute 


Name 


Type 


Description 


input-trays-ready 


Settable with the pdcreate or pdset commands, 
printer attribute file. 


or by the 


Explanation 


Identifies the types of input trays (such as top or 
envelope) presently available in the physical printer 
device. 


Value 


Values 


Type 


Multiple values. 


A text string of up to 255 characters that describes the 
input tray, or one of the following fixed values: 


top 

middle 

bottom 

envelope 

manual 

large-capacity 

main 

side 


Default 


No default. 


Usage 

Guidelines 


Attribute 


Name 


Type 


Usage 


Description 


input-trays-supported 


Settable with the pdcreate or pdset commands, 
printer attribute file. 


Values vary by printer model. 


or by the 


Explanation 


Identifies the types of input trays (such as top or 
envelope) that are installed in the physical printer 
device. 


Value 


Values 


Type 


Multiple values. 


A text string of up to 255 characters that describes the 
input tray, or one of the following fixed values: 


top 

middle 

bottom 

envelope 

manual 

large-capacity 

main 
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side 


Default | No default 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


interface-program-methods-supported 


Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 


Identifies the invocation methods supported by this 
printer. 


Single value. 


Any of the following fixed values: 

hpdps 

IP 


No default. 


o The job attribute interface-program-method is compared 
to this attribute for validation. 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


job-attributes-supported 


Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 


Values vary by printer model. 


Identifies the job attributes supported by this printer. 


Multiple values. 


Any of valid job attributes in pd_att_job(5). 


job-batch 


o The job attributes are compared to this attribute for 
scheduling and validation. 


Attribute 


Name 


Type 


Value Type 


Values 


Description 


job-batches-ready 


Settable attribute which job-batch values 
are acceptable to this physical printer. 


Multiple values. 


A text string up to 4095 characters in length, 
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| per value, that contains the job-batch name. 

Default 

No default. 

Usage 

Guidelines 

The value of the job attribute job-batch is compared with 
this attribute during job-scheduling 

i 

Attribute 

Description 

Name 

job-finishings-ready 

Type 

Settable 

Explanation 

Indicates the finishing methods available on this printer. 

Value Type 

Single value. 

Values 

staple 

top-left-staple 

Default 

No default. 

Usage 

Guidelines 

The value of this attribute must be supported by 
job attribute finishings-supported 

i 

Attribute 

Description 

Name 

job-finishings-supported 

Type 

Settable 

Explanation 

Indicates the finishing method supported by this printer. 

Value Type 

Single value. 

Values 

staple 

top-left-staple 

Default 

No default. 

Usage 

Guidelines 

To verify if a printer is capable of performing a 
finishing process on a print job. 

i 

Attribute 

Description 

Name 

job-sheets-supported 

Type 

Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 

Usage 

Values vary by printer model. 

Explanation 

Identifies the auxiliary sheets supported by this printer. 

Value Type 

Multiple values. 

Values 

Any of the following fixed values: 


none 
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job-separators 

job-set-start 

job-set-end 

job-set-wrap 

job-set-start-copies-separate 

job-set-end-copies-separate 

job-set-wrap-copies-separate 

job-copy-start 

job-copy-end 

j ob-copy-wrap 


Default | No default. 


o The job attribute job-sheets is compared to this 
attribute for scheduling and validation, 
o The auxiliary-sheet-package object is not implemented. 
These values are used to select the auxiliary sheets. 

Most printer models support the following 2 values: 

o none 

No auxiliary sheets, or banner pages, are 
printed with the job. 

o job-set-start 

A banner page is printed at the start of each 
job-result-set. For most printers, this means 
a single banner page is printed before the 
job documents are printed. 


Attribute 

Description 

Name 

job-size-range-ready 

Type 

Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 

Explanation 

Defines the range of job sizes in bytes the physical 
printer can currently accept and print. 

Value Type 

Single value. 

Values 

This is a complex attribute with the following values: 


o lower limit 
o upper limit 


Two integers separated by a colon (:). Each integer can 
be from 0 to 9223372036854775800. The first integer is 
the lower limit and the second integer is the upper 
limit. The lower limit must be less than or equal to the 
upper limit. Unit value is octets (bytes). 


| Syntax 

| lower limit:upper limit 



| For example: 0:65000. 


| Default 

| 0:9223372036854775800 



Usage | o The range for this attribute value must be contained 


Usage 

Guidelines 
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Guidelines 


within the range of job-size-range-supported. 

The job attribute total-job-octets is compared to 
this attribute for scheduling. 


Component 


Description 


lower 

limit 


Explanation: Lower limit value of job size. 

Value Type: Single 

Values: Unit value is octets (bytes). If only the 

lower limit is supplied, the upper limit defaults to 
9223372036854775800. 


upper 

limit 


Explanation: Upper limit value of job size. 

Value Type: Single 

Values: Unit value is octets (bytes). If only the 

upper limit is supplied, the lower limit defaults to 

0 . 


Attribute 

Name 


Description 

job-size-range-supported 


Type 


Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 


Explanation 


Defines the range of job sizes this physical printer can 
accept. 


Value Type 
Values 


Single value. 


This is a complex attribute with the following 
components: 


lower limit 
upper limit 


Two integers separated by a colon (:). Each integer can 
be from 0 to 9223372036854775800. The first integer is 
the lower limit and the second integer is the upper 
limit. The lower limit must be less than or equal to the 
upper limit. Unit value is octets (bytes). 


Syntax 


lower limit:upper limit 
For example: 0:65000 
0:9223372036854775800 


Default 


Usage 

Guidelines 


The job attribute total-job-octets is compared to 
this attribute for validation. 


Component 


Description 


lower 

limit 


Explanation: Lower limit value of job size. 

Value Type: Single 

Values: Unit value is octets (bytes). If only the 

lower limit is supplied, the upper limit defaults to 
9223372036854775800. 


upper 

limit 


Explanation: Upper limit value of job size. 
Value Type: Single 
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Values: Unit value is octets (bytes). If only the 

upper limit is supplied, the lower limit defaults to 

0 . 


Attribute 

Description 




Name 

list-of-managers 




Input 

Synonym 

managers 




Type 

Settable with the pdcreate or pdset 

commands. 



Explanation 

Identifies the people responsible for the maintenance and 
operation of this physical printer. 

Value Type 

Multiple values. 




Values 

A text string that contains the IDs of the people 
responsible for this physical printer. 


Default 

No default. 




i 

Usage | 

Guidelines | 

1 

Attribute 

Description 




Name 

maximum-copies-supported 




Type 

Settable with the pdcreate or pdset 
printer attribute file. 

commands, 

or by the 

Explanation 

Indicates the number of document copies, in a 
print job, allowed by this physical printer. 

single 


Value Type 

Single value. 




Values 

An integer from 0 to 2147483647. 




Default 

2147483647 




Usage 

Guidelines 

o If the value for this attribute is "0", there is 

limit to the number of document copies. 
o The document attribute copy-count is compared to 

attribute for scheduling. 

no 

this 

i 

Attribute 

Description 




Name 

maximum-printer-speed 




Type 

Settable with the pdcreate or pdset 
printer attribute file. 

commands, 

or by 

the 

1 

Usage | 

Explanation 

Specifies the maximum speed of the printer in 

pages 

Der 


minute. 
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Value Type 

Single value. 

Values 

An integer from 0 to 2147483647 

Default 

none 

Usage 

Guidelines 

o The job attribute printer-speed-range-requested is 

compared to this attribute for scheduling. 

i 

Attribute 

Description 

Name 

media-ready 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Identifies the media presently loaded in the printer. 

Value Type 

Multiple values. 

Values 

Any of the following fixed values or any text string up 


to 255 characters that contains the medium names. 

iso-a4-white 

iso-a4-colored 

iso-a4-transparent 

iso-a3-white 

iso-a3-colored 

iso-a5-white 

iso-a5-colored 

iso-b4-white 

iso-b4-colored 

iso-b5-white 

iso-b5-colored 

na-letter-white 

na-letter-colored 

na-letter-transparent 

na-legal-white 

na-legal-colored 

iso-b5-envelope 

iso-b4-envelope 

iso-c4-envelope 

iso-c5-envelope 

designated-long-envelope 

na-10xl3-envelope 

na-9xl2-envelope 

monarch-envelope 

na-number-10-envelope 

na-7x9-envelope 

na-9x11-envelope 

na-10xl4-envelope 

na-number-9-envelope 

na-6x9-envelope 

na-10xl5-envelope 

jis-b4-white 

jis-b4-colored 

jis-b5-white 

jis-b5-colored 

executive 

folio 

invoice 

ledger 
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quarto 

iso-aO-white 

iso-al-white 

iso-a2-white 

iso-a6-white 

iso-a7-white 

iso-a8-white 

iso-a9-white 

iso-al0-white 

iso-bO-white 

iso-bl-white 

iso-b2-white 

iso-b3-white 

iso-b6-white 

iso-b7-white 

iso-b8-white 

iso-b9-white 

iso-bl0-white 

jis-bO-white 

jis-bl-white 

jis-b2-white 

jis-b3-white 

jis-b6-white 

jis-b7-white 

jis-b8-white 

jis-b9-white 

jis-bl0-white 

a 

b 

c 

d 

e 


Default 


Usage 

Guidelines 


No default. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


media-supported 


Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 


Identifies the types of media supported by the physical 
printer. 


Multiple values. 


Any of the following fixed values or any text string up 
to 255 characters that contains the medium names. 


iso-a4-white 

iso-a4-colored 

iso-a4-transparent 

iso-a3-white 

iso-a3-colored 

iso-a5-white 

iso-a5-colored 

iso-b4-white 
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1 

iso-b4-colored 



1 

iso-b5-white 



1 

iso-b5-colored 



1 

na-letter-white 



1 

na-letter-colored 



1 

na-letter-transparent 



1 

na-legal-white 



1 

na-legal-colored 



1 

iso-b5-envelope 



1 

iso-b4-envelope 



1 

iso-c4-envelope 



1 

iso-c5-envelope 



1 

designated-long-envelope 



1 

na-10xl3-envelope 



1 

na-9xl2-envelope 



1 

monarch-envelope 



1 

na-number-10-envelope 



1 

na-7x9-envelope 



1 

na-9x11-envelope 



1 

na-10xl4-envelope 



1 

na-number-9-envelope 



1 

na-6x9-envelope 



1 

na-10xl5-envelope 



1 

jis-b4-white 



1 

jis-b4-colored 



1 

jis-b5-white 



1 

jis-b5-colored 



1 

executive 



1 

folio 



1 

invoice 



1 

ledger 



1 

quarto 



1 

iso-aO-white 



1 

iso-al-white 



1 

iso-a2-white 



1 

iso-a6-white 



1 

iso-a7-white 



1 

iso-a8-white 



1 

iso-a9-white 



1 

iso-al0-white 



1 

iso-bO-white 



1 

iso-bl-white 



1 

iso-b2-white 



1 

iso-b3-white 



1 

iso-b6-white 



1 

iso-b7-white 



1 

iso-b8-white 



1 

iso-b9-white 



1 

iso-bl0-white 



1 

jis-bO-white 



1 

jis-bl-white 



1 

jis-b2-white 



1 

jis-b3-white 



1 

jis-b6-white 



1 

jis-b7-white 



1 

jis-b8-white 



1 

jis-b9-white 



1 

jis-bl0-white 



1 

a 



1 

b 



1 

c 



1 

d 
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e 


Default 


No default. 


Usage | o The document attribute default-medium is compared to 

Guidelines | this attribute. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


message 


Settable with the pdcreate or pdset commands. 


Information associated with the physical printer. 


Single value. 


A text string up to 4095 characters that contains 
information about this physical printer. 


No default. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


maximum-concurrent-jobs 


Non Settable. 


Identifies the number of of jobs that can be processed by 
this printer concurrently. 


Single Value. 


Any of the following fixed values: 


| 1 

I 

| Set by HPDPS. 

Default | 1 

Usage | 

Guidelines | 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


multiple-documents-supported 


Non Settable. 


Identifies whether this printer is capable of processing 
and printing multiple documents per job. 


Single value. 


One of the following fixed values: 
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false 

true 


Default 


true 


Usage 

Guidelines 


Attribute 


Name 


Type 


Description 


notification-profile 


Settable with the pdcreate or pdset commands. 


Explanation 


Designates which users are to be notified of specified 
events related to this physical printer, and how they are 
to be notified. 


Value 


Values 


Type 


Multiple values. 


This is a complex attribute which has the following 
components: 


o event-identifiers 
o delivery-method 
o event-comment 
o delivery-address 
o locale 


Syntax 


-x "notification-profile={event-identifiers=value 
delivery-method=value event-comment= 'text' 
delivery-address=value locale=value}" 


For example: 


-x "notification-profile={event-identifiers= 

class-physical-printer-status 

delivery-method=electronic-mail 

event-comment='Its still going' 

delivery-address=jeff@ttank 

locale=C}" 


Component 


Description 


event- | Explanation: Specifies the events for which the user 

identifiers| is to receive messages. 

| Value Type: Multiple values. 

| Values: Any of the values listed for spooler attribute 
| events-supported in pd_att_spooler(5). 

| Default: 

| o object-deleted 

| o object-cleaned 

| o printer-needs-administrator 

| o printer-needs-attention 

| o printer-needs-operator 

| o printer-paper-jam 

| o printer-paper-out 

| o printer-paper-output-problem 

| o printer-timed-out 
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delivery 

method 


event- 

comment 


Explanation: Specifies how the user is to receive 
event messages. 

Value Type: Single value. 

Values: One of the following fixed values: 

Fixed Value Input Synonym 

electronic-mail e-mail, email 

message 
none 

Default: electronic-mail 


Explanation: Supplies textual information that is 
appended to the event message. 

Value Type: Single value. 

Values: A text string up to 4095 characters that 
contains the comment. 

Default: No default. 


delivery- | Explanation: The address of the person to receive the 
address | event messages. 

| Value Type: Single value. 

| Values: A text string that contains the user name and 
| host, such as jeff@ttank 

| Default: The login of the user that created this 
| physical printer with the pdcreate command. 


locale 


Explanation: Provides the locale identification so 
the message is sent in the correct language. 
Value Type: Single value. 

Values: Locale identification. 

Default: The locale of the user that created this 
physical printer with the pdcreate command. 


Attribute 


Name 


Type 


Description 


numbers-up-supported 


Settable with the pdcreate or pdset commands, 
printer attribute file. 


or by the 


Explanation 


Identifies the number-up values supported by this printer. 
See the explanation of document attribute number-up in 
pd_att_document(5) for more information on number-up 
values. 


Value 


Values 


Type 


Multiple values. 


Any of the following fixed values: 


0 

1 

2 

4 


Default 


No default. 


Usage | o The document attribute number-up is compared to this 

Guidelines | attribute for validation. 


Attribute 


Description 
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Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Syntax 


notify-operator 


operators 


Settable with the pdcreate or pdset commands. 


Identifies people that are to receive the attribute 
job-message-to-operator message. 


Multiple values. 


This is a complex attribute, which has the following 
components: 

o delivery-method 
o delivery-address 


-x M notify-operator=dm value:da value" 


For example: message:op2@phyptrl 


Component 


Description 


delivery- 

method 


Explanation: Specifies how the person is to receive 
the messages. 

Value Type: Single value. 

Values: One of the following fixed values: 
electronic-mail 
message 
none 

Default: electronic-mail 


delivery- 

address 


Explanation: The address of the person to receive the 
messages. 

Value Type: Single value. 

Values: The user ID and host of the person. 

Default: The login of the person who created this 
physical printer with the pdcreate command. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


object-class 


Non Settable 


Identifies the object class to which this object belongs. 


Single value. 


The value of this attribute is printer. 


printer 


Attribute 


Description 


Name 


output-bins-supported 
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Type 

Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 

Usage 

Values vary by printer model. 

Explanation 

Identifies the output bins supported by this printer. 

Value Type 

Multiple values. 

Values 

A text string of up to 255 characters that describes the 
output bin, or any of the following fixed values: 


top 

middle 

bottom 

side 

left 

right 

face-up 

face-down 

large 

private 

collator 

Default 

No default 

Usage 

Guidelines 

o The job attribute results-profile component output-bin 

is compared to this attribute for validation. 

i 

Attribute 

Description 

Name 

page-select-supported 

Type 

Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 

Usage 

Values vary by printer model. 

Explanation 

Identifies the types of page identifiers supported by this 
printer, either numeric or alphanumeric string, or both. 
Only the numeric type is currently supported. This 
attribute specifies the acceptable values that may be 
given for document attribute page-select; see 
pd_att_document(5) for more information. 

Value Type 

Multiple values. 

Values 

Any of the following fixed values: 


numeric 

Default 

No default 

Usage 

Guidelines 

o The document attribute page-select is compared to 

this attribute for validation. 

i 

Attribute 

Description 
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Name 


Type 


Usage 


plexes-supported 


Settable with the pdcreate or pdset commands, 
printer attribute file. 


Values vary by printer model. 


or by the 


Explanation 


Identifies the plexes supported by this printer. Plex 
indicates whether the page images of the output document 
are conditioned for eventual one-sided or two-sided 
printing, and the relative orientation of consecutive 
pages. 


Value Type 


Multiple values. 


Values 


Any of the following fixed values: 


simplex 

duplex 

tumble 


(single sided) 

(double sided) 

(double sided, every other page upside-down) 


Default 

i 

No 

default. 


Usage 

i 

o 

The document attribute plex is compared to 

this 

Guidelines 

i 

i 

o 

attribute for scheduling. 

HPDPS defaults "sides=2 M when plex=duplex. 

HPDPS 


not currently perform any other conditioning when 
plex=duplex. 


does 


Attribute 


Name 


Type 


Usage 


Explanation 


Value Type 


Values 


Default 


Description 


printer-community-name 


Settable with the pdcreate or pdset commands. 


Values vary by printer model. 


Identifies the password used for SNMP communication with 
the printer whose attachment-type is tcpip. 


Single value. 


A text string up to 255 that contains the physical 
printer's community name. 


internal 


Usage | o May be set with the pdcreate command at the time of 

Guidelines | physical printer creation if the attachment-type is 

| tcpip. Ignored for other attachment-types. 


Attribute 


Name 


Type 


Explanation 


Description 


printer-mopy-ready 


Settable 


Indicates if printer printer's multiple copy feature is 
ready for use. 
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Value Type 

Single boolean value. 

Values 

true, or false. 

Default 

No default. 

Usage 

Guidelines 

The value of this attribute must be supported by job 
attribute printer-mopy-supported. 

i 

Attribute 

Description 

Name 

printer-mopy-supported 

Type 

Settable 

Explanation 

Indicates if printer is capable of printing multiple 
copies by spooling a job in internal storage. 

Value Type 

Single boolean value. 

Values 

true, or false. 

Default 

No default. 

Usage 

Guidelines 

To verify if multiple copies can be printed by submitting 
a job to the printer once. 

i 

Attribute 

Description 

Name 

print-queue-name 

Input 

Synonym 

print-queue 

Type 

Specifiable with the pdcreate command. 

1 

Usage | 

Explanation 

Specifies which lp/bsd queue is associated with this 
physical printer. 

Value Type 

Single value. 

Values 

A text string up to 255 characters that contains the name 
of the lp/bsd queue. 

Default 

No default. 

Usage 

Guidelines 

o Must be set with the pdcreate command at the time of 
creation if the attachment-type is one of the 
following: 


tcpip-bsd 

lp-spool-hp 

lp-spool-bsd 


Ignored for other attachment-types. 

The value identifies the name of the HP-UX lp spooler 
destination or BSD spooler queue associated with the 
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| physical printer. 

1 

Attribute 

i 

| Description 

Name 

| printer-locations 

Input 

Synonym 

| locations 

Type 

| Settable with the pdcreate or pdset commands. 

Explanation 

| Identifies the locations of the physical printer devices. 

Value Type 

| Multiple values. 

Values 

| Any text string up to 4095 characters that contains the 
| actual physical location of the physical printer devices. 

Default 

| No default. 

Usage 

Guidelines 

| o The job attribute printer-locations-requested is 

| compared to this attribute for scheduling. 

i 

Attribute 

i 

| Description 

Name 

| printer-model 

Input 

Synonym 

| model 

Type 

| Specifiable with the pdcreate command. 

Explanation 

| Identifies the model ID defined by the manufacturer of 
| the physical printer device. 

Value Type 

| Single value. 

Values 

| A text string up to 4095 characters that contains the 
| model ID. 

Default 

| No default. 

Usage 

Guidelines 

| o Must be set with the pdcreate command at the time of 
| physical printer creation unless the attachment-type 
| is one of the following: 


| lp-spool-hp 

| lp-spool-bsd 


| o The job attribute printer-models-requested is 

| compared to this attribute for scheduling. 

i 

Attribute 

i 

| Description 

Name 

| printer-name 

Input 

Synonym 

| printer, physical-printer 
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Type 

Non Settable 



Explanation 

Identifies the physical printer object. 



Value Type 

Single value. 



Values 

A text string up to 255 characters that contains 
name of this physical printer. 

the 



Set by HPDPS from the argument used with the pdcreate 
command. 


Default 

No default. 



Usage 

Guidelines 

o The job attribute physical-printer-requestec 

compared to this attribute for validation, 
o The name must be unique within the DCE cell. 

is 


i i 

Attribute 

Description 


i 

Name 

printer-needs-attention-time 



Type 

Non Settable 



Explanation 

Reports the amount of time the printer has been 
for simple intervention, such as loading paper. 

waiting 


Value Type 

Single value. 



Values 

[HH:]MM. Unit is minutes. 



Default 

No default. 



i i 

Usage | | 

Guidelines | | 

1 1 

Attribute 

Description 


i 

Name 

printer-needs-key-operator-attention-time 



Type 

Non Settable 



Explanation 

Reports the amount of time the printer has been 
for attention by a key (or skilled) operator. 

waiting 


Value Type 

Single value. 



Values 

[HH:]MM. Unit is minutes. 



Default 

No default. 



i i 

Usage | | 

Guidelines | | 

1 1 

Attribute 

Description 


i 

Name 

printer-pass-through 



Input 

other-options 
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Synonym | 

Type 

Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 

1 

Usage | 

Explanation 

Contains information to be passed to the printer 
interface program. 

Value Type 

Single value. 

Values 

A text string up to 255 characters that contains 
information for the printer interface program. 

Default 

No default. 

Usage 

Guidelines 

o The value of this attribute is passed as the 4th 

argument of the interface program. 

i 

Attribute 

Description 

Name 

printer-realization 

Type 

Specifiable with the pdcreate command. 

Explanation 

Indicates whether the printer has been designated as a 
physical or a logical printer. 

Value Type 

Single value. 

Values 

One of the following fixed values: 


physical 

Default 

physical 

i 

Usage | 

Guidelines | 

1 

Attribute 

Description 

Name 

printer-resolutions-supported 

Type 

Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 

Explanation 

Identifies the resolutions supported by the printer. 

Value Type 

Multiple Values 

Values 

This is a complex attribute with the following components: 


o An optional object identifier with one of the 
following fixed values: 


highest 

lowest 

medium 
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| o An integer from 0 to 2147483647. 

i 

i 

Syntax 

[object identifier:]integer value 

i 


| For example: highest:600, or 300 

i 

Component 

Description 

i 

1st 

component 

| Explanation: If given, the 1st component specifies an 
| object identifier that is associated with the 

| resolution value given in the 2nd component. 

| This component is optional. 

i 

i 

i 

i 


| If a job specifies the value of the default-printer- 

| resolution attribute to be one of these object 

| identifiers (highest/lowest/medium), this component 

gives the mapping of that object identifier to the 
actual resolution specified by the 2nd component. 

i 

i 

i 

i 

i 

2nd 

component 

i 

| Explanation: Actual resolutions in dots per inch supported| 

| by this printer. | 

Default 

| none 

i 

Usage 

Guidelines 

| o The document attribute default-printer-resolution is 

| compared to this attribute for validation. 





Attribute 

| Description 


Name 

| printer-resource-context-printer 

■ 

Type 

Non Settable. 

1 

Explanation 

| Identifies the location of the information about the 
| printer model. 


Value Type 

| Single value. 


Values 

| A text string up to 4095 characters that contains the 
| path name of the printer information location. 


Default 

| No default. 


Usage 

Guidelines 






Attribute 

Description 


Name 

printer-state 


Type 

| Non Settable 


Explanation 

| Identifies the current state of the printer. 


Value Type 

Single value. 


Values 

| One of the following fixed values: 



connecting-to-printer 
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idle 

needs-attention 

needs-key-operator 

paused 

printing 

timed-out 


Default 


No default. 


Usage 

Guidelines 


Attribute 

Name 


Description 

printer-tcpip-internet-address 
tcpip-internet-address, internet-address 


Input 

Synonym 


Type 

Usage 

Explanation 


Settable with the pdcreate or pdset commands. 


Sets the Internet Address parameter for TCP/IP attached 
printers. This is the Internet Protocol address assigned 
to the printer. 


Value Type 
Values 


Single value. 

A text string up to 4095 characters that contains either 


Dotted decimal address 


A series of 4 integers within 
the range of 0 to 255, each 
separated by a period (.). 

For example: 15.0.65.103 


Hostname 


Such as hppddev4.cup.hp.com 


Default 


No default. 


Usage 

Guidelines 


o Must be set with the pdcreate command at the time of 
physical printer creation if the attachment-type is 
one of the following: 


tcpip 

tcpip-bsd 

lp-spool-hp 

lp-spool-bsd 


Ignored for other attachment-types. 


| Attribute 

| Description 


| Name 

| printer-tcpip-port-number 


| Input 

| tcpip-port-number, port-number 


| Synonym 

i 


1 Type 

| Settable with the pdcreate or pdset commands. 
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-1-1 

Usage | | 

Explanation 

Sets the Port Number parameter for TCP/IP attached 
printers. This is the TCP/IP port number configured at 
the physical printer device. 

i 

i 

i 

i 

Value Type 

Single value. 

i 

Values 

An integer from 9100 to 9102. 

i 

Default 

9100 

i 

Usage 

Guidelines 

o May be set with the pdcreate command at the time of 

physical printer creation if the attachment-type is 
tcpip. Ignored for other attachment-types. 

i 

i 

i 

i i 

Attribute 

Description 

i 

1 

Name 

printer-timeout-period 

i 

Input 

Synonym 

timeout-period 

i 

i 

Type 

Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 

i 

i 

1 1 

Usage | | 

Explanation 

Specifies the amount of time (in seconds) the supervisor 
is allowed to connect to a shared network printer 
(physical printer device) after the physical printer 
receives a new job request. 

i 

1 

Value Type 

Single value. 


Values 

An integer from 0 to 2147483647. The unit is seconds. 


Default 

60 seconds 


Usage 

Guidelines 

o While the supervisor is attempting to connect to the 

printer device, the physical printer is in the 
connecting-to-printer state, and it can still accept 
jobs. See the description of the maximum-concurrent- 
jobs attribute. 

o If the supervisor cannot connect to the printer 

device within the specified time, the following 
happens unless the time is not 0: 

- The printer-state becomes timed-out 

— A warning message may be issued, depending on the 

notification profile of this physical printer. 

- The supervisor continues to try to connect to the 
printer device until successful, or until the job 
is canceled or paused. 


i i 

Attribute 

Description 

i 

1 

Name 

printer-types 

i 

Type 

Settable with the pdcreate or pdset commands. 

i 


HP-UX Release 11.0: October 1997 


-32- 


Section 5-221 


























pdattphyptr (5) 


pdattphyptr (5) 


Explanation 


Value Type 


Values 


Identifies the marking technologies of the printer 


Multiple values. 


One of the following fixed values: 


other 

electrophotographic-led 

electrophotographic-laser 

electrophotographic-other 

impact-moving-head-dot-matrix-9-pin 

impact-moving-head-dot-matrix-24-pin 

impact-moving-head-dot-matrix-other 

impact-moving-head-fully-formed 

impact-band 

impact-other 

inkjet-aqueous 

inkjet-solid 

inkjet-other 

pen 

thermal-transfer 

thermal-sensitive 

thermal-diffusion 

thermal-other 

electro-erosion 

electro-static 

photographic-microfiche 

photographic-imagesetter 

photographic-other 

ion-deposition 

E-beam 

typesetter 


Default 


No default. 


Usage | o The job attribute printer-types-requested is compared 

Guidelines | to this attribute for scheduling and validation. 


Attribute 


Name 


Type 


Explanation 


Description 


registered-with-spooler 


Non Settable 


Indicates whether the physical printer and spooler have 
established communication. 


Value 


Values 


Type 


Single value. 


One of the following fixed values: 
Fixed Value Input Synonym 

true yes 

false no 


Default 


false 


Usage 

Guidelines 
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Attribute | Description 

Name 

sides-supported 

Type 

Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 

Explanation 

Identifies whether the printer can print on one or two 
sides of the media. 

Value Type 

Multiple values. 

Values 

An integer of 1 or 2. To support both single-sided and 
double-sided printing, use both value 1 and value 2 as 
separate values for this multiple-valued attribute. 

Default 

No default 

Usage 

Guidelines 

o The document attribute sides is compared to this 

attribute for scheduling. 

i 

Attribute 

Description 

Name 

start-message-supported 

Type 

Settable with the pdcreate or pdset commands, or by the 
printer attribute file. 

Explanation 

Indicates whether the physical printer supports the job 
attribute job-start-message. If supported, the printer 
will be able to send the specified message to the persons 
identified in the notify-operator attribute. 

Value Type 

Single value. 

Values 

One of the following fixed values: 

Fixed Value Input Synonym 

true yes 

false no 

Default 

true 

Usage 

Guidelines 

o The job attribute job-start-message is compared to 

this attribute for validation. 
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NAME 

pd_att_queue - list of attributes for an HP DPS queue object 

DESCRIPTION 

The following is a list of valid attributes and values for the queue object class of the HP Distributed Print 
Service. 


Attributes for a Queue Object 


Settable Attribute Listing 



backlog-lower-bound 

backlog-udpdate-interval 

backlog-upper-bound 

descriptor 

list-of-managers 

message 

notify-operator 

notification-profile 

protected-attributes 

scheduler-ready 


Specifiable Attribute Listing 


There are no specifiable 
attributes for a queue object. 


Table 1-1. Queue Attributes 


Attribute 


Explanation 


Value Type 


Usage 

Guidelines 


Attribute 


Explanation 


Value Type 


Description 


associated-server 


Non Settable 


Indicates the name of the server in which this queue 
resides. 


Single value. 


A text string up to 255 characters that contains the name 
of the server. Implicitly set from the argument 
(ServerName:QueueName) specified when this queue was 
created with the pdcreate command. 


No default. 


Description 


backlog-lower-bound 


Settable with the pdcreate and pdset commands. 


Identifies the limit (time to print jobs within the 
queue) below which the queue is not considered 
backlogged. A backlogged condition is reset when the 
queue-backlog value is less than this value, if backlog 
computing is enabled. 


Single value. 
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Values 

[HH:]MM. Unit is minutes. 

Syntax 

backlog-lower-bound=[HH:]MM. 


Can be just minutes or hours and minutes. 


For example: -x "backlog-lower-bound=5" 

or 

-x "backlog-lower-bound=l:10" 

Default 

No default. 

Usage 

Guidelines 

o The value for this attribute must be less than or 

equal to the value specified for the 
backlog-upper-bound attribute, 
o The value for the attribute backlogged is reset to 

false when the value for the queue-backlog attribute 
becomes less than this value if backlog computing is 
enabled (backlog-update-interval value not equal to 

0) . 

i 

Attribute 

Description 

Name 

backlog-update-interval 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Specifies how often the queue backlog is computed. 

Value Type 

Single value. 

Values 

[HH:]MM. Unit is minutes. 


If set to 0, backlog computing is disabled. 

Default 

The greater value of the following: 


1 minute 

or 

The value of the backlog-upper-bound attribute 
divided by 30. 

Usage 

Guidelines 

o The value for this attribute must be less than or 

equal to the value specified for the 
backlog-upper-bound attribute. 
o This default value is set when the queue is created. 

If the value for the backlog-upper-bound attribute is 
changed later with the pdset, the value for this 
attribute is not changed. 

i 

Attribute 

Description 

Name 

backlog-upper-bound 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Identifies the limit (time to print the jobs in the 
queue) above which the queue is considered backlogged. 
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Value Type 


Values 


Default 


Single value. 


[HH:]MM. Unit is minutes. 


No default. 


Usage 

Guidelines 


o The value for this attribute must be greater than or 
equal to the value specified for the 
backlog-lower-bound attribute, 
o The value for the attribute backlogged is set to true 
when the value for the queue-backlog attribute 
exceeds this value if backlog computing is enabled. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


backlogged 


Not Settable 


Identifies whether the queue is backlogged. 


Single value. 


One of the following fixed values: 


Fixed Value Input Synonym 

true yes 

false no 


Default 


false 


Usage 

Guidelines 


o This attribute value is set to true when backlog 
computing is enabled (backlog-update-interval not 
equal to 0) and the queue-backlog value exceeds 
backlog-upper-bound. 

o This attribute value is set to false when the 
queue-backlog value falls below the 
backlog-lower-bound value. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Description 


descriptor 


Settable with the pdcreate or pdset commands. 


Provides a description of this queue. 


Single value. 


Values 


A text string up to 4095 characters that describes this 
queue. You may want to specify such things as: 
o The name of the department or the account number for 
the users of this queue. 

o Any other information that is unique to your company 
or organization. 


Default 


No default 


Usage | o The use of this attribute is optional. However, a 

Guidelines | detailed description of this queue is helpful to users 
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who want to determine where to submit a given job or 
administrators who want to determine which queue to 
associate with a logical printer. 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Description 


list-of-managers 


managers 


Settable with the pdcreate or pdset commands. 


Lists the people responsible for the maintenance and 
operation of this queue. 


Multiple values. 


A text string up to 255 characters per person that 
contains the name or ID of the person responsible for 
this queue. 


No default. 


Description 


logical-printers-assigned 


Non Settable. 


Lists the logical printers associated with this queue. 


Multiple values. 


A text string up to 255 characters per printer that 
contains the logical printer global ID. Implicitly set 
to the logical printer attribute associated-queue value 
when the logical printer is created. 


No default. 


Description 


logical-printers-ready 


Non Settable. 


Lists the enabled logical printers that are associated 
with this queue. 


Multiple values. 
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Values 


A text string up to 255 characters that contains the ID 
of the physical printers (per printer) that are ready to 
accept jobs. Implicitly set when physical printers are 
enabled and have a state of either idle, 
connecting-to-printer, or printing. Implicitly reset 
when a physical printer is disabled, paused, timed-out, 
needs-attention, or needs-key-operator-attention. 


Default 


No default. 


Usage 

Guidelines 


The list changes as logical printers are enabled or 
disabled. 


Attribute 

Name 


Description 


message 

Settable with the pdcreate or pdset commands. 


Type 

Explanation 


Provides a message associated with this queue. 
Single value. 


Value Type 
Values 


A text string up to 4095 characters that contains 
information about this queue. 


Default 


No default. 


Usage 

Guidelines 


Attribute 

Name 


Description 

notification-profile 


Type 

Explanation 


Settable with the pdcreate or pdset commands. 


Designates which persons are to be notified of specific 
events related to this queue, and how they are to be 
notified. 


Value Type 
Values 


Multiple Values 


This is a complex attribute, which has the following 
components: 

o event-identifiers 
o delivery-method 
o event-comment 
o delivery-address 
o locale 


Syntax 


-x "notification-profile={event-identifiers=events 
delivery-method=value event-comment='text' 
deliver-address=value locale=value}" 

For example: 

-x "notification-profile={event-identifiers=class-error 
delivery-method=electronic-mail 
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event-comment= fix problem' delivery-address=mary@travel 
locale=C}" 


Component 


Description 


event- 

identifiers 


Explanation: Specifies the events for which the 
person is to receive messages. 

Value Type: Multiple values. 

Values: Any of the event values listed for spooler 
attribute events-supported in pd_att_spooler. 
Default: 

o object-deleted 
o object-cleaned 
o queue-backlogged 


delivery- 

method 


Explanation: Specifies how the user is to receive the 
event messages. 

Value Type: Single value. 

Values: One of the following fixed values: 

Fixed Value Input Synonym 

electronic-mail e-mail, email 

file 

file-add-to 

message 

none 

Default: electronic-mail 


event- 

comment 


Explanation: Supplies textual information that is 
appended to the message 
Value Type: Single value. 

Values: A text string up to 4095 characters that 

supplies additional information concerning the event. 
Default: No value. 


delivery- | Explanation: The address of the person that is to 
address | receive the event messages. 

| Value Type: Single value. 

| Values: A text string that contains the name and node 
| of the person that is to receive notification. 

| Default: The login of the person that created the 
| queue with the pdcreate command. 


locale 


Explanation: Identifies the locale that the messages are 
to be sent in. 

Value Type: Single value. 

Values: A text string that identifies the locale to 

be used. This is used to determine the language and 
coded character set that the information is to be 
sent in. 

Default: The locale of the person that created this 
queue with the pdcreate command. 


Attribute 


Name 


Input 

Synonym 


Type 


Description 


notify-operator 


operators 


Settable with the pdcreate or pdset commands. 
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Explanation 


Identifies people that are to receive 
job-message-to-operator message. 


Value Type 


Multiple values. 


the 


attribute 


Values 


This is a complex attribute with the following 
components: 
o delivery-method 
o delivery-address 


Syntax 


-x "notify-operator=delivery-method value: 
delivery-address value" 


For example: -x "notify-operator=message:op3@fastpr" 


Component 


Description 


delivery- 

method 


Explanation: Specifies how the person is to receive 
the messages. 

Value Type: Single Value 

Values: One of the following fixed values: 
electronic-mail 
message 
none 

Default: electronic-mail 


delivery- 

address 


Explanation: The address of the person that is to 
receive the message. 

Value Type: Single Value 

Values: A text string that contains the user ID and 

node of the person that is to receive the message. 

Default: The login of the person that created this 
queue. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


object-class 


Non Settable 


Identifies the object class to which this object belongs. 


Single value. 


The value of this attribute is queue 


queue 


Attribute 


Name 


Type 


Explanation 


Description 


physical-printers-assigned 


Non Settable 


Lists the physical printers that receive jobs from this 
queue. 
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Value Type 

Multiple values. 

Values 

A text string up to 255 characters per printer that 
contains the ID of a physical printer that is associated 
with this queue. Implicitly set when a physical printer 
registers and its associated-queue attribute value is the 
name of this queue. 

Default 

No default. 

i 

Usage | 

Guidelines | 

1 

Attribute 

Description 

Name 

physical-printers-ready 

Type 

Non Settable 

Explanation 

Lists the enabled physical printers that can receive a 
job from this queue. 

Value Type 

Multiple values. 

Values 

A text string up to 255 characters per printer that 
contains the global ID of a physical printer assigned to 
this queue that is ready. 

Default 

No default. 

Usage 

Guidelines 

o A physical printer becomes ready when it is enabled 

and the state is either idle, connecting-to-printer, 
or printing. 

i 

Attribute 

Description 

Name 

protected-attributes 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Specifies one or more queue attributes that you do not 
want HPDPS operators to set or change. 

Value Type 

Multiple values. 

Values 

One or more queue attribute names. 

Default 

protected-attributes 

Usage 

Guidelines 

o Normally, anyone with DCE write permission for queues 

can set values for queue attributes. By default, the 


pd_admin and pd_operator DCE groups both have write 
permission. Once you define a queue attribute as a 
protected attribute, DCE delete permission is required 
to modify the attribute. Members of the pd_operator 
DCE group do not have delete permission unless 
modifications have been made to the default 
permissions for that group. 
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Attribute 


Input 

Synonym 


Explanation 


Value Type 


Usage 

Guidelines 


Attribute 


Explanation 


Value Type 


Usage 

Guidelines 


Attribute 


Explanation 


Value Type 


Description 


queue-backlog 


backlog, current-backlog 


Non Settable 



Specifies the amount of time that this queue might be | 
backlogged. This is a computed estimate of time it will | 
take to print all of the jobs currently in the queue. | 


Single value. 


[HH:]MM. Unit is minutes. 


No default. 


Description 


queue-name 


Non Settable 


Uniquely identifies this queue object. 


Single value. 



A text string up to 255 characters that contains the name 
of this queue. Set by the argument 

(ServerName:QueueName) of the pdcreate command when this 
queue was created. 


No default. 


o Name of this queue must be unique within the DCE 
cell. 


Description 


queue-state 


Non Settable 


Identifies the current state of the queue. 


Single value. 


One of the following fixed values: 

paused 

ready 


No default. 
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Guidelines 




Attribute 

Description 

Name 

scheduler-ready 

Input 

Synonym 

scheduler 

Type 

Settable with the pdcreate or pdset commands. 

Explanation 

Identifies the scheduling method used to determine the 
order in which jobs in the queue are sent to physical 
printers. 

Value Type 

Single Value 

Values 

One of the following fixed values: 

f ifo 

priority-fifo 

Must be one of the spooler attribute schedulers-supported 
values. 

Default 

priority-fifo 

Usage 

o This attribute can be changed even if there are jobs 

Guidelines 

currently in the queue. The jobs currently in the 
queue will be reordered according to the new 
scheduler. 
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NAME 

pd_att_spooler - list of attributes for an HP DPS spooler object 

DESCRIPTION 

The following is a list of valid attributes and values for the spooler object class of the HP Distributed Print 
Service. 


Attributes for a Spooler Object 


Settable Attribute Listing 


descriptor 

job-submission-timer 

list-of-managers 

message 

notification-profile 

printer-register-threshold 

protected-attributes 

security-level 


Specifiable Attribute Listing 


There are no specifiable 
attributes for a spooler object. 


Table 1-1. 

Spooler Attributes 


Attribute 

| Description 


Name 

| cancel-individual-document-supported 


Type 

| Non Settable 


Explanation 

i 

| Indicates whether the spooler is capable of canceling 
| individual documents within a multiple-document job. 

Value Type 

i 

| Single value. 


Values 

i 

| The acceptable value is false or its synonym. 

Default 

i 

| false 


i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 


Name 

| descriptor 


Type 

| Settable with the pdset command. 


Explanation 

| Provides a description of this spooler. 


Value Type 

| Single value. 


Values 

| A text string up to 4095 characters that 
| description of this spooler. 

contains a 

Default 

| No default. 


i 

Usage | 

Guidelines | 
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Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


document-attributes-supported 


Non Settable 


Identifies the document attributes supported by the 
spooler. 


Multiple values. 


Any of the following fixed values: 


content-orientation 
copy-count 
default-input-tray 
default-medium 
document-comment 
document-content 
document-file-name 
document-format 
document-sequence-number 
document-type 
initial-value-document 
object-class 
octet-count 
page-count 

plex See Note 

print-quality See Note 

printer-initial-value-document 
printer-pass-through See Note 

sides See Note 

transfer-method 


See 

Note 

at 

end 

of 

list 

See 

Note 

at 

end 

of 

list 

See 

Note 

at 

end 

of 

list 


at end of list 
at end of list 


at end of list 
at end of list 


Note: This value is dynamic; it is added and removed 

depending on the default values of the physical printers 
that are registered. 


Default 


Usage 

Guidelines 


No default. 


Attribute 

| Description 

Name 

| events-supported 

Type 

| Non Settable 

Explanation 

| Lists the events supported by the spooler. 

Value Type 

| Multiple values. 

Values 

| Any of the following fixed values: 


class-aborted 
class-error 
class-job-attention 
class-job-default 
class-job-problem 


HP-UX Release 11.0: October 1997 


-2- 


Section 5-235 




















pdattspool er (5) 


pdattspool er (5) 




i 

class-job-status 




i 

class-logical-printer-attention 




i 

class-logical-printer-default 




i 

class-logical-printer-configuration 




i 

class-logical-printer-status 




i 

class-queue-attention 




i 

class-queue-default 




i 

class-queue-configuration 




i 

class-queue-status 




i 

class-server-attention 




i 

class-server-default 




i 

class-server-configuration 




i 

class-server-status 




i 

class-report 




i 

class-state-changed 




i 

class-warning 




i 

close-to-discard-time 




i 

internal-server-error 




i 

job-aborted-by-server 




i 

job-assigned-to-queue 




i 

job-canceled-by-operator 




i 

job-canceled-by-user 




i 

job-cannot-be-scheduled 




i 

job-completed 




i 

j ob-dis carded 




i 

job-modified 




i 

job-paused 




i 

j ob-promoted 




i 

j ob-requeued 




i 

job-resubmitted 




i 

job-resumed 




i 

job-state-changed 




i 

job-submission-not-complete 




i 

j ob-timed-out 




i 

no-document 




i 

object-cleaned 




i 

object-created 




i 

object-deleted 




i 

object-modified 




i 

object-paused 




i 

object-resumed 




i 

past-discard-time 




i 

printer-disabled 




i 

printer-enabled 




i 

printer-registered 




i 

printer-shutdown-job-requeued 




i 

printer-unregistered 




i 

processing-started 




i 

queue-backlogged 




i 

queue-no-longer-backlogged 




i 

queue-state-changed 




i 

server-startup-complete 




i 

server-shutdown-complete 




i 

server-shutdown-started 




i 

server-state-changed 



Default 

i 

No default. 



Usage 

i 




Guidelines 

i 




_ 

_ | 
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Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


job-attributes-supported 


Non Settable 


Identifies the job attributes supported by this spooler. 


Multiple values. 


Any of the following fixed values: 


completion-time 
current-job-state 
initial-value-job 
intervening-jobs 
job-batch 
job-client-id 
job-comment 
job-copies-completed 
j ob-dis card-time 
j ob-end-me s s age 
job-finishing 
job-hold 
job-identifier 

job-message-from-administrator 

job-message-to-operator 

job-name 

job-originator 

job-owner 

job-print-after 

job-priority 

job-retention-period 

job-start-message 

job-state-reasons 

job-submission-complete 

modification-time 

name-of-last-accesser 

new-job-identifier 

notification-profile 

number-of-documents 

object-class 

octets-completed 

on-request-resources-required 

pages-completed 

physical-printer-requested 

previous-job-state 

print-checkpoint 

printer-initial-value-job 

printer-locations-requested 

printer-models-requested 

printer-name-requested 

printers-assigned 

printers-used 

processing-time 

queue-assigned 

results-profile 

started-printing-time 

submission-time 

total-job-octets 

user-locale 

user-name 
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Default 

I 

| No default. 

i 

Usage | 

Guidelines | 

1 

Attribute 

| Description 

Name 

1 

| job-state-reasons-supported 

Type 

1 

| Non Settable 

Explanation 

1 

| Identifies the job-state reasons that are supported by 
| this spooler. 

Value Type 

1 

| Multiple values. 

Values 

1 

| Any of the following fixed values: 


| aborted-by-system 
| canceled-by-operator 
| canceled-by-user 
| successful-completion 
| job-hold-set 
| job-print-after-specified 
| required-resources-not-ready 
| required-resources-not-supported 

Default 

1 

| No default. 

i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 

Name 

1 

| job-states-supported 

Type 

1 

| Non Settable 

Explanation 

1 

| Identifies the job-states supported by this spooler. 

Value Type 

1 

| Multiple values. 

Values 

1 

| Any of the following fixed values: 




canceled 

held 

paused 

pending 

pre-processing 

processing 

retained 

terminating 

timed-out 


unknown 


Default | No default. 


Usage 


Guidelines 
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Attribute 

i 

| Description 



Name 

| job-submission-timer 



Type 

| Settable with the pdset command. 



Explanation 

| Specifies the maximum time to wait between 
| submissions. 

job 


Value Type 

| Single value. 



Values 

| [HH:]MM. Unit is minutes. 



Default 

| 30 minutes 



i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 



Name 

| list-of-managers 



Input 

Synonym 

| managers 



Type 

| Settable with the pdset command. 



Explanation 

i 

| Lists the people that are responsible for the 
| maintenance and operation of this spooler. 


Value Type 

i 

| Multiple values. 



Values 

i 

| A text string up 255 characters that contain the name Or 
| user IDs of the people responsible for this spooler. 

Default 

i 

| No default. 



i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 



Name 

| locale 



Type 

| Non Settable 



Explanation 

| Identifies the locale for this spooler. 



Value Type 

| Single value. 



Values 

i 

| A text string up to 255 characters that contains 
| locale ID of this spooler. 

the 

Default 

i 

| No default. 



Usage 

Guidelines 

| o Derived from the environment variables 

| spooler at startup time. The priority 

1 obtain the locale from the environment 

for this 
sequence to 
variables is: 
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1. LCALL 

2. LC_MESSAGES 

3. LANG 


1 

Attribute 

| Description 

1 

1 

Name 

1 

| logical-printers-ready 

1 

1 

Type 

1 

| Non Settable 

1 

1 

1 

Explanation 

1 

| Identifies which logical printers within this spooler 
| are ready to accept jobs. 

1 

1 

1 

Value Type 

1 

| Multiple values. 

1 

1 

1 

1 

1 

Values 

1 

| A text string up to 255 characters that contains the ID 
| of the enabled logical printers. Implicitly set and 
| reset when logical printers are enabled or disabled 
| within this spooler. 

1 

1 

1 

1 

1 

Default 

1 

| No default. 

1 

1 

1 

Usage 

Guidelines 

i 

i 

i 

1 

1 

1 


1 


1 

1 

Attribute 

1 

| Description 

1 

1 

1 

Name 

1 

| logical-printers-supported 

1 

1 

1 

Type 

1 

| Non Settable 

1 

1 

1 

1 

Explanation 

1 

| Identifies the logical printers that are supported by 
| this spooler. 

1 

1 

1 

Value Type 

1 

| Multiple values. 

1 

1 

1 

1 

Values 

1 

| Any text string up to 255 characters per logical 
| printer. Implicitly set when logical printers are 
| created or deleted within this spooler. 

1 

1 

1 

1 

Default 

1 

| No default. 

1 

1 

1 

Usage 

Guidelines 

i 

i 

i 

1 

1 

1 


1 


1 

1 

Attribute 

1 

| Description 

1 

1 

1 

Name 

1 

| message 

1 

1 

1 

Type 

1 

| Settable with the pdset command. 

1 

1 

1 

Explanation 

1 

| Contains information associated with this spooler. 

1 

1 

1 

Value Type 

1 

| Single value. 

1 

1 

1 

1 

Values 

1 

| A text string up to 4095 characters that contains 
| information that is associated with this spooler. 

1 

1 

1 

Default 

1 

| No default. 

1 
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Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 

Name 

| modify-individual-document-supported 

Type 

| Non Settable 

Explanation 

| Indicates whether this spooler is capable of modifying 
| individual documents within a multiple document job. 

Value Type 

| Single value. 

Values 

| The only value is false. 

Default 

| false 

i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 

Name 

| multiple-documents-supported 

Type 

| Non Settable 

Explanation 

| Indicates whether multiple documents per job are 
| supported by this spooler. 

Value Type 

| Single Value 

Values 

| The only value is true. 

i 

Default 

i 

| true 

i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 

Name 

| notification-delivery-methods-supported 

Type 

| Non Settable 

Explanation 

| Identifies the methods that are supported by this 
| spooler for sending messages to the person that is to 
| receive them. 

Value Type 

| Multiple values. 

Values 

| Any of the following fixed values: 


| electronic-mail 
| message 
| file 

1 file-add-to 
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none 


Default 


No default. 


Usage 

Guidelines 


Attribute 


Name 


Type 


Description 


notification-profile 


Settable with the pdset command. 


Explanation 


Designates which users are to be notified of specific 
events related to this spooler, and how they are to be 
notified. 


Value 


Values 


Type 


Multiple Values 


This is a complex attribute, 
components: 


which has the following 


o event-identifiers 
o delivery-method 
o event-comment 
o delivery-address 
o locale 


Syntax 


-x "notification-profile={event-identifiers=events 
delivery-method=value event-comment='text' 
delivery-address=value locale=value}" 


For example: 


-x "notification-profile={event-identifiers= 
class-server-status delivery-method=electronic-mail 
event-comment='Too much data' 
delivery-address=Tom@master locale=C}" 


Component 


Description 


event- | Explanation: Specifies the events for which the 

identifiers | person is to receive messages. 

| Value Type: Multiple values. 

| Values: Any of the values listed for spooler attribute 
| events-supported. 

| Default: 

| o internal-server-error 

| o object-cleaned 

| o object-deleted 

| o server-shutdown-complete 


delivery- 

method 


Explanation: Specifies how the user is to the 
receive event messages. 

Value Type: Single value. 

Values: One of the following fixed values: 
Fixed Value Input Synonym 

electronic-mail 

message e-mail, email 

file 

file-add-to 
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none 

Default: message 


event-comment| Explanation: A text string of information that is 
| appended to the event message. 

| Value Type: Single value. 

| Values: A text string up to 4095 characters that 
| contains the comment. 

| Default: No value. 


Explanation: The address of the person that is to 

receive event messages concerning this spooler. 

Value Type: Single value. 

Values: A text string that contains the user ID and 
node of the person that is to receive the event 
messages. 

Default: The login of the user that created this 
spooler. 


locale | Explanation: Identifies the locale so the messages 

| can be sent in the language of the person that is to 

| receive them. 

| Value Type: Single value. 

| Values: A text string that contains the locale of 
| the person that is to receive the messages. 

| Default: The locale of the person that created this 
| spooler. 


delivery- 

address 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


object-class 


Non Settable 


Identifies the object class to which this object 
belongs. 


Single value. 


The value of this attribute is server. 


server 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


object-classes-supported 


Non Settable 


Lists the object classes supported by this spooler. 


Multiple values. 


Any of the following fixed values: 


document 

initial-value-document 
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initial-value-job 

job 

log 

printer 

queue 

server 


Default 


No default. 


Usage 

Guidelines 


Attribute 

| Description 

Name 

| physical-printers-ready 

Type 

| Non Settable 

Explanation 

| Identifies the supported physical printers that are 
| ready to receive jobs from queues in this spooler. 

Value Type 

| Multiple values. 

Values 

| A text string up to 255 characters that contains the ID 
| of the physical printers (per printer) that are ready to 
| accept jobs. Implicitly set when physical printers 
| associated with queues in this spooler are enabled and 
| have a state of either idle, connecting-to-printer, or 
| printing. Implicitly reset when a physical printer is 
| disabled, paused, timed-out, needs-attention, or 
| needs-key-operator-attention. 

Default 

| No default. 

Usage 

Guidelines 

| o A physical printer is ready when it is enabled and 

| the state is either idle, connecting-to-printer, or 

| printing. 

i 

Attribute 

i 

| Description 

Name 

| physical-printers-supported 

Type 

| Non Settable 

Explanation 

| Identifies the physical printers that are supported by 
| this spooler. 

Value Type 

| Multiple values. 

Values 

| A text string up to 255 characters per physical printer 
| that contains the IDs of the physical printers that are 
| associated with the queues contained in this spooler. 

| Implicitly set when physical printers associated with 
| queues in this spooler register with this spooler. 

Default 

| No default. 


Usage 

Guidelines 
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Attribute 

| Description 


Name 

| printer-register-threshold 


Input 

Synonym 

| register-threshold 

1 


Type 

| Settable with the pdset command. 


Explanation 

| Indicates the amount of time this spooler waits after 
| being re-initialized for a physical printer to 
| re-register. When the physical printer re-registers, 

| provides information about jobs that were processing 
| when this spooler was shutdown. 

it 

Value Type 

| Single value. 


Values 

| [HH:]MM 


Default 

| 10 minutes 


Usage 

Guidelines 

i 

| o If the physical printer does not re-register within 

| the time period and provide status about the jobs it 

| received, the spooler changes the state of the jobs 

| from unknown to timed-out. 

i 

Attribute 

i 

| Description 


Name 

| problem-child 


Type 

| Non Settable 


Explanation 

| Identifies whether one of the objects managed by this 
| spooler has a problem or not. 


Value Type 

| Single value. 


Values 

| One of the following fixed values: 



| true 
| false 


Default 

| No default. 


Usage 

Guidelines 

| Used by SAM to determine the problem status of this 
| spooler. 


i 

Attribute 

i 

| Description 


Name 

| protected-attributes 


Type 

| Settable with the pdcreate or pdset commands. 


Explanation 

i 

| Specifies one or more spooler attributes that you do not 
| want HPDPS operators to set or change. 

Value Type 

i 

| Multiple values. 


Values 

1 

1 One or more spooler attribute names. 
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Default 


protected-attributes 


Usage | o Normally, anyone with DCE write permission for 

Guidelines | spooler can set values for spooler attributes. 

| By default, the pd_admin and pd_operator DCE groups 

| both have write permission. Once you define a 

| spooler attribute as a protected attribute, DCE 

| delete permission is required to modify the 

| attribute. Members of the pd_operator DCE group do 

| not have delete permission unless modifications have 

| been made to the default permissions for that group. 


Attribute 

| Description 





Name 

| queues-supported 





Type 

| Non Settable 





Explanation 

i 

| Identifies the queues that 
| spooler. 

are contained 

in this 


Value Type 

i 

| Multiple values. 





Values 

| A text string up to 255 
| of the queues contained 
| when queues are created 

characters that 
in this spooler, 
or deleted. 

contains the 
Implicitly 

IDs 

set 

Default 

| No default. 






Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


schedulers-supported 


Non Settable 


Identifies the scheduling algorithms supported by this 
spooler. 


Multiple values. 


Any of the following fixed values: 


f ifo 

priority-fifo 


Default | fifo 

| priority-fifo 


Usage 

Guidelines 


Attribute 


Description 


Name 


security-level 
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Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Syntax 


Default 


Usage 

Guidelines 


Attribute 


Name 


Input 

Synonym 


Type 


Explanation 


Value Type 


Values 


Settable with the pdset command. 


Identifies the security level for this spooler. 


Multiple values. 


The only value supported is medium. 


medium 


Description 


server-hostname 


hostname 


Non Settable 


Name of the host processor on which this spooler is 
running. 


Single Value 


A text string up to 4095 characters that contains the 
hostname of this server. Implicitly set to the hostname 
where this spooler was created. 


node.node.node 

For example: boxer.denver.gym.com 


No default. 


Description 


server-ip-address 


ip-address, i-p-address 


Non Settable 


The Internet Address of the host processor on which this 
spooler is running. 


Single Value 


A text string that contains the Internet Address for 
this spooler in format of 4 integers in series within 
the range of 0 to 255. Each integer is separated from 
the others by a period (.). Implicitly set to the 
ip-address of the host on which this spooler is created. 
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1 

Syntax 

| nn.nn.nn.nn 

i 

1 


| For example: 15.1.1.1 

i 

1 

Default 

| No default. 

i 

1 

1 

Usage 

Guidelines 

i 

i 

i 

i 

1 




1 

1 

Attribute 

| Description 

i 

1 

1 

Name 

| server-name 

i 

1 

1 

Type 

| Non Settable 

i 

1 

1 

Explanation 

| Uniquely identifies this spooler. 

i 

1 

1 

Value Type 

| Single value. 

i 

1 

1 

1 

1 

Values 

| A text string up to 255 characters 
| this spooler. Implicitly set from 
| when the startspl utility is run. 

that contains name of | 
the name specified | 

1 

1 

Default 

| No default. 

i 

1 

1 

Usage 

Guidelines 

i 

i 

i 

i 

1 




1 

1 

Attribute 

| Description 

i 

1 

1 

Name 

| server-state 

i 

1 

1 

Type 

| Non Settable 

i 

1 

1 

Explanation 

i i 

| Identifies the current state of this spooler. | 

1 

1 

Value Type 

i 

| Single value. 

i 

1 

1 

1 

Values 

| One of the following fixed values: 

i 

1 

1 

1 

1 


| initializing 
| ready 
| terminating 
| unavailable 

i 

i 

i 

i 

1 

Default 

| No default. 

i 

1 

1 

Usage 

Guidelines 

i 

i 

i 

i 

1 




1 

1 

Attribute 

| Description 

i 

1 

1 

Name 

| server-type 

i 

1 

1 

Type 

| Non Settable 

i 

1 

1 

1 

Explanation 

i i 

| Identifies the type of server, either spooler or | 

| supervisor. | 

1 
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Value Type 


Values 


Default 


Usage 

Guidelines 


Single value. 


The value is spooler. 


spooler 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


transfer-methods-supported 


Non Settable 


Identifies the transfer-methods supported by this 
spooler. 


Multiple values. 


Any of the following fixed values: 

dce-pipe-pull 

with-request 


dce-pipe-pull 

with-request 


o The document attribute transfer-method is compared 
to this attribute for validation and scheduling. 
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NAME 

pd_att_supervisor - list of attributesfor an HPDPS supervisor object 

DESCRIPTION 

The following is a list of valid attributes and values for the supervisor object class of the HP Distributed 
Print Service. 


Attributes for a Supervisor Object 


Settable Attribute Listing | 

Specifiable attribute Listing 

descriptor | 
job-submission-timer | 
list-of-managers | 
message | 
notification-profile | 
protected-attributes | 
security-level | 
server-resource-context-printer| 

There are no specifiable 
attributes for a supervisor 
server object. 


Table 1-1. 

Supervisor Attributes 

Attribute 

| Description 

Name 

| cancel-individual-document-supported 

Type 

| Non Settable 

Explanation 

| Indicates whether this supervisor is capable of 
| cancelling individual documents within a multiple 
| document job. 

Value Type 

| Single value. 

Values 

| The only value is false. 

Default 

| false 

i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 

Name 

| descriptor 

Type 

| Settable with the pdset command. 

Explanation 

| Provides a description of this supervisor. 

Value Type 

| Single value. 

Values 

| A text string up to 4095 characters that describes this 
| supervisor. 

Default 

| No default. 

i 

Usage | 

Guidelines | 
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Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


events-supported 


Non Settable 


Lists the events supported by this supervisor. 


Multiple values. 


Any of the following fixed values: 


checkpoint-taken 

class-aborted 

class-error 

class-physical-printer-attention 

class-physical-printer-default 

class-physical-printer-configuration 

class-physical-printer-status 

class-report 

class-server-attention 

class-server-default 

class-server-configuration 

class-server-status 

class-state-changed 

class-warning 

detailed-messages 

document-aborted-by-printer 

document-aborted-by-server 

document-cancelled-at-printer 

document-content 

file-transferred 

internal-server-error 

job-aborted-by-server 

job-cancelled-by-operator 

job-cancelled-by-user 

job-completed 

no-document 

no-resource 

object-cleaned 

object-created 

object-deleted 

object-modified 

object-paused 

object-resumed 

other-error 

other-warning 

printer-disabled 

printer-enabled 

printer-function-unavailable 

printer-needs-administrator 

printer-needs-attention 

printer-needs-operator 

printer-paper-jam 

printer-paper-out 

printer-paper-output-problem 

printer-registered 

printer-shutdown-j ob-requeued 

printer-state-changed 

printer-timed-out 

printer-toner-low 
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| | printer-unregistered | 

| | processing-started | 

| | resource-needs-attention | 

| | resource-needs-operator | 

| | server-shutdown-complete | 

| | server-shutdown-started | 

| | server-startup-complete | 

| | server-state-changed | 

| | unable-to-register | 

| | unrecognized-resource | 

i 

| Default 

i 

| No default. 

i 

1 

1 

| Usage 

1 

1 

1 

1 

| Guidelines 

i 

i 

i i i 

i 

| Attribute 

i 

| Description 

i 

| Name 

| job-state-reasons-supported 


1 Type 

| Non Settable 


| Explanation 

| Identifies the job-state reasons that are supported by 



| this supervisor. 


| Value Type 

| Multiple values. 


| Values 

| Any of the following fixed values: 



| successful-completion 



| cancelled-by-user 



| cancelled-by-operator 



| aborted-by-system 


| Default 

| No default. 


| Usage 

i 


| Guidelines 

i 



i 

| Attribute 

I 

| Description 

I 

| Name 

| job-states-supported 


1 Type 

| Non Settable 


| Explanation 

| Identifies the job-states supported by this supervisor. 


| Value Type 

| Multiple values. 


| Values 

| Any of the following fixed values: 



| cancelled 



| processing 



| terminating 


i i i 

| Default | | 

i 

| Usage 

i 

1 

i 

1 

| Guidelines 

i- 

i 

i- 

i 

--i 
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Attribute 

| Description 

Name 

| job-submission-timer 

Type 

| Settable with the pdset command. 

Explanation 

| Specifies the maximum time to wait for job submissions 
| to complete. 

Value Type 

| Single value. 

Values 

| [HH:]MM. The unit is minutes. 

Default 

| 30 minutes 

i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 

Name 

| list-of-managers 

Input 

Synonym 

| managers 

Type 

| Settable with the pdset command. 

Explanation 

| Lists the people that are responsible for the 
| maintenance and operation of this supervisor. 

Value Type 

| Multiple values. 

Values 

| A text string that contains the name or user IDs of the 
| people that are responsible for this supervisor. 

Default 

| No default. 

i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 

Name 

| locale 

Type 

| Non Settable 

Explanation 

| Identifies the locale of this supervisor. 

Value Type 

| Single value. 

Values 

| A text string up to 4095 characters that contains the 
| locale ID of this supervisor. 

Default 

| No default. 

Usage 

Guidelines 

| o Derived from the environment variable for this 

| supervisor at the startup time. The priority 

| sequence to obtain the locale from the environment 

1 variables is: 
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| 1. LCALL | 

| 2 . LC ME S SAGE S | 

| 3. LANG | 

1 1 

Attribute 

i 

| Description 



i 

Name 

| message 




Type 

| Settable with the pdset command. 




Explanation 

i 

| Information associated with this supervisor. 



Value Type 

i 

| Single value. 




Values 

i 

| A text string up to 4095 characters that contains the 
| information associated with this supervisor. 


Default 

i 

| No default. 




i i 

Usage | | 

Guidelines | | 

1 1 

Attribute 

i 

| Description 



i 

Name 

| multiple-documents-supported 




Type 

| Non Settable 




Explanation 

| Indicates whether multiple documents per 
| supported by the supervisor. 

job 

are 


Value Type 

| Single value. 




Values 

| The only value is true. 




Default 

| true 




i i 

Usage | | 

Guidelines | | 

1 1 

Attribute 

i 

| Description 



i 

Name 

| notification-delivery-methods-supported 




Type 

| Non Settable 




Explanation 

i 

| Identifies the notification delivery methods 
| by this supervisor. 

supported 


Value Type 

i 

| Multiple values. 




Values 

1 

| Any of the following fixed values: 





electronic-mail 

message 

file 

file-add-to 
none 
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Default 


No default. 


Usage 

Guidelines 


Attribute 


Name 


Type 


Description 


notification-profile 


Settable with the pdset command. 


Explanation 


Designates which users are to be notified of specific 
events related to the supervisor, and how they are to be 
notified. 


Value 


Values 


Type 


Multiple values. 


This is a complex attribute, 
components: 


which has the following 


o event-identifiers 
o delivery-method 
o event-comment 
o delivery-address 
o locale 


Syntax 


-x "notification-profile={event-identifiers=events 
delivery-method=value event-comment='text' 
delivery-address=value locale=value}" 


For example: 


-x "notification-profile={event-identifiers= 
object-cleaned object-deleted 
delivery-method=electronic-mail 
event-comment='Better check' 
delivery-address=dave@final local=C}" 


Component 


Description 


event- | Explanation: Specifies the events for which the 

identifiers | person is to receive messages. 

| Value Type: Multiple values. 

| Values: Any of the values listed for supervisor 
| attribute events-supported. 

| Default: 

| o internal-server-error 

| o object-cleaned 

| o object-deleted 

| o server-shutdown-complete 


delivery- 

method 


Explanation: Specifies how the user is to receive 
the event messages. 

Value Type: Single value. 

Values: One of the following fixed values: 

Fixed Value Input Synonym 

electronic-mail e-mail, email 

message 
file 

file-add-to 
none 
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Default: electronic-mail 


event-comment| Explanation: Information that is appended to the 
| event message. 

| Value Type: Single value. 

| Values: A text string up to 4095 characters that 
| contains the comment. 

| Default: No default. 


Explanation: The address of the person that is to 
receive the event messages. 

Value Type: Single value. 

Values: A text string that contains the user ID and 
node of the person that is to receive the event 
messages. 

Default: The login of the person that created this 
supervisor. 


locale | Explanation: Identifies the locale of the person to 

| receive the event messages. The locale is used to 

| determine which language the messages are to be sent 

| in. 

| Value Type: Single value. 

| Values: A text string that contains the locale of 
| the person that is to receive the messages. 

| Default: The locale of the person that created this 
| supervisor. 


delivery- 

address 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


object-class 


Non Settable 


Identifies the object class to which this object 
belongs. 


Single value. 


The value of this attribute is server. 


server 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


object-classes-supported 


Non Settable 


Lists the object classes supported by this server. 


Multiple values. 


Any of the following fixed values: 


job 

document 
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| printer 
| server 

1 log 

Default 

1 

| No default. 

i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 

Name 

1 

| physical-printers-ready 

Type 

1 

| Non Settable. 

Explanation 

1 

| Identifies the physical printers contained within this 
| supervisor that are ready to accept jobs. 

Value Type 

1 

| Multiple values. 

Values 

1 

| A text string up to 255 characters that contains the ID 
| of the physical printers (per printer) that are ready to 
| accept jobs. Implicitly set when physical printers are 
| enabled and have a state of either idle, 

| connecting-to-printer, or printing. Implicitly reset 
| when a physical printer is disabled. 

Default 

1 

| No default. 

i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 

Name 

1 

| physical-printers-supported 

Type 

1 

| Non Settable 

Explanation 

1 

| Identifies the physical printers that are contained in 
| this supervisor. 

Value Type 

1 

| Multiple values. 

Values 

1 

| Any text string up to 255 characters that contains the 
| IDs of the physical printers that are contained within 
| this supervisor. Implicitly set and reset when physical 
| printers are created or deleted. 

Default 

1 

| No default. 

i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 

Name 

1 

| printer-models-supported 

Type 

1 

| Non Settable 

i- 
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Explanation 


Value Type 


Identifies the physical printer models that can be 
created within this supervisor. 


Multiple values. 


Values 


Any text string up to 255 characters that contains the 
IDs of the physical printer models that can be created 
within this supervisor. 


Default 


No default. 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


printer-states-supported 


Non Settable 


Identifies the printer states that are supported by this 
supervisor. 


Multiple values. 


Any of the following fixed values: 


connecting-to-printer 
idle 

needs-attention 

needs-key-operator 

paused 

printing 

timed-out 


Default 


Usage 

Guidelines 


No default. 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Description 


problem-child 


Non Settable 


Identifies if one of the objects managed by this 
supervisor has a problem or not. 


Single values. 


Any of the following fixed values: 


true 

false 


Default 


No default. 


Usage 

Guidelines 
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Attribute 

i 

| Description 


Name 

1 

| protected-attributes 


Type 

1 

| Settable with the pdcreate or pdset commands. 


Explanation 

1 

| Specifies one or more supervisor attributes that you 
| not want HPDPS operators to set or change. 

do 

Value Type 

1 

| Multiple values. 


Values 

1 

| One or more supervisor attribute names. 


Default 

1 

| protected-attributes 


Usage 

Guidelines 

i 

| o Normally, anyone with DCE write permission for 

| supervisor can set values for supervisor attributes. 

| By default, the pd_admin and pd_operator DCE groups 

| both have write permission. Once you define a 

| supervisor attribute as a protected attribute, DCE 

| delete permission is required to modify the 

| attribute. Members of the pd_operator DCE group do 

| not have delete permission unless modifications have 

| been made to the default permissions for that group. 

i 

Attribute 

i 

| Description 


Name 

1 

| security-level 


Type 

1 

| Settable with the pdset command. 


Explanation 

1 

| Identifies the security level for this supervisor. 


Value Type 

1 

| Single value. 


Values 

1 

| The following value is the only supported value. 



| medium 


Default 

1 

| medium. 


i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 


Name 

1 

| server-hostname 


Input 

Synonym 

1 

| hostname 

1 


Type 

1 

| Non Settable 


Explanation 

1 

| Name of the host processor on which this supervisor 
| running. 

is 

Value Type 

1 

| Single value. 
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1 

1 

1 

1 

Values 

| A text string up to 255 characters that contains the 
| name of the host on which this supervisor is running. 

| Implicitly set to the name of the host on which this 
| supervisor was created. 

1 

1 

1 

1 

1 

Syntax 

| node.node.node 

1 

1 


| For example: paper.endicott.jc.com 

1 

1 

Default 

| No default. 

1 

1 

1 

Usage 

Guidelines 

i 

i 

1 

1 





1 

Attribute 

| Description 

1 

1 

Name 

| server-ip-address 

1 

1 

1 

Input 

Synonym 

| ip-address, i-p-address 

1 

1 

1 

1 

Type 

| Non Settable 

1 

1 

1 

Explanation 

| The Internet Address of the host processor on which this 
| supervisor is running. 

1 

1 

1 

Value Type 

| Single value. 

1 

1 

1 

1 

Values 

| A text string that contains the Internet Address for 
| this supervisor. Implicitly set to the ip-address of 
| the host on which this supervisor was created. 

1 

1 

1 

1 

1 

Syntax 

| nn.nn.nn.nn 

| Each integer can be from 0 to 255. 

1 

1 

1 

1 


1 

| For example: 15.1.1.1 

1 

1 

1 

Default 

| No default. 

1 

1 

1 

Usage 

Guidelines 

i 

i 

1 

1 

1 




1 

1 

Attribute 

| Description 

1 

1 

1 

Name 

| server-name 

1 

1 

1 

Type 

| Non Settable 

1 

1 

1 

Explanation 

| Uniquely identifies this supervisor. 

1 

1 

1 

Value Type 

| Single value. 

1 

1 

1 

1 

1 

1 

Values 

| A text string up to 255 characters that contains the 
| name of this supervisor. Implicitly set from the name 
| specified by the startsuv utility when this supervisor 
| was created. 

1 

1 

1 

1 

1 

Default 

| No default. 

1 

1 

Usage 

i 

1 
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Guidelines 

i 


1 

Attribute 

1 

| Description 

Name 

1 

| server-resource-context-printer 

Type 

1 

| Settable with the pdset command. 

Explanation 

1 

| Specifies the pathnames where printer model configuration 
| information reside. 

Value Type 

1 

| Single Value 

Values 

1 

| A text string up to 4095 characters that contains the 
| pathname(s). 

Default 

1 

| /opt/pd/lib/model 

Usage 

1 

| o The supervisor uses the value of this attribute to 

Guidelines 

| locate printer model information when creating a 


physical printer object. 

o Multiple paths are separated by a colon . For 


example, "/opt/pd/lib/model:/home/user/model". 

The supervisor looks for printer model information 
beneath each path in the order specified. 


Attribute 

| Description 

Name 

| server-state 

Type 

| Non Settable 

Explanation 

| Identifies the current state of this supervisor. 

Value Type 

| Single value. 

Values 

| One of the following fixed values: 


| initializing 
| ready 
| terminating 
| unavailable 

Default 

| No default. 

i 

Usage | 

Guidelines | 

1 

Attribute 

i 

| Description 

Name 

| server-type 

Type 

| Non Settable 

Explanation 

| Identifies the type of server, either spooler or 
| supervisor. 

Value Type 

| Single value. 
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Values | The value is supervisor 


Default | supervisor 


Usage 

Guidelines 


Attribute 


Name 


Type 


Explanation 


Value Type 


Values 


Default 


Usage 

Guidelines 


Description 


transfer-methods-supported 


Non Settable 


Identifies the transfer-methods supported by this 
supervisor. 


Multiple values. 


Any of the following fixed values: 

dce-pipe-pull 

with-request 


dce-pipe-pull 

with-request 


o The document attribute transfer-method is compared 
to this attribute for validation and scheduling. 
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NAME 

pfs exports, pfsxtab - directories to export to PFS clients 

SYNOPSIS 

/etc/pfs_exports 

/etc/pfs_xtab 

DESCRIPTION 

The /etc/pfs_exports file contains entries for directories that can be exported to PFS clients. This 
file is read automatically by the pfs_exportfs(lM) command. If you change this file, you must run 
pfs_exportfs(lM) for the changes to affect the daemon's operation. 

It is recommended that you place a command in rc(lM) so that pfs_exportfs(lM) is executed at boot time. 

The /etc/pfs_xtab file contains entries for directories that are currently exported. You should not 
modify this file directly. Future updates to the PFS package will contain librariesfor editing this file. (Use 
the -u option of pf s_exportf s to remove entries from this file). 

An entry for a directory consists of a lineof thefollowingform: 

d i rectory -opti on [, opti on ]... 
where 

directory is the pathname of a directory (or file), 
option is one of 

access=dient [: client] . . . 

Give mount access to each client listed. A client must be a hostname. The 
default valueallowsany machineto mount thegiven directory. 

A '#’ (pound-sign) anywhere in the file indicates a comment that extends to the end of theline. 

EXAMPLE 

/usr/local # export to the world 

/usr2 -access=hermes:zip:tutorial # export to only these machines 


AUTHOR 

pfs_exports was developed by Young Minds, I nc. 


FILES 

/etc/pfs_exports 
/etc/pfs_xtab 
/etc/hosts 


SEE ALSO 

hosts(5), pfs_exportfs(lM), pfsd(lM), pfs_mountd(lM), rc(lM). 


HP-UX Release 11.0: October 1997 


1 - 


Section 5-263 


pfs_fstab(5) 


pfs_fstab(5) 


NAME 

pfs_fstab, mtab - static file system mounting table, mounted file systems table 

SYNOPSIS 

/etc/pfs_fstab 

/etc/mtab 

DESCRIPTION 

The /etc/pf s_f stab file contains entries for CD-ROM file systems and disc images to mount using the 
pfs_mount(lM) command, which is normally invoked by rc(lM) script at boot time. This file is used by 
various utilities such aspfs_mount, and pfs_umount. 

The /etc/mtab file contains entries for file systems currently mounted, and is read by programs using 
the routines described in getmntent(3). umount (see mount(lM)) removes entries from this file. 

Each entry consists of a line of the form: 

filesystem directory type options freq pass 

filesystem is the pathname of a raw or block-special device, the name of a remote file system in 
host: pathname form, or the name of a file created with MakeDisc. 

directory is the pathname of the directory on which to mount the file system. 

type is the file system type, which can be one of: 

pfs-iso9660 to mount a device as iso9660. 
pfs-hsfs to mount a device as hsfs. 

pfs-rrip to mount a device as rrip. 

pfs-nfs to mount an exported PFS filesystem 

options contains a comma-separated list (no spaces) of mounting options, some of which can be 
applied to all types of file systems, and others which only apply to specific types. 

options valid on all file systems: 

ro Even if not specified, this option is implied. 

suid| nosuid Setuid execution allowed or disallowed. 

bg | fg I f the first attempt fails, retry in the background, or, in the foreground. 

retry=n The number of times to retry the mount operation. 

rsize=n Set the read buffer size to n bytes. 

timeo=n Set the PFS timeout to n tenths of a second. 

retrans=n The number of PFS retransmissions. 

soft | hard Return an error if the server does not respond, or continue the retry 
request until the server responds, 
intr Allow keyboard interrupts on hard mounts, 

options specific to iso9660 and hsfs filesystems: 

xlat=xlat_flags 

xlat_flags is a colon (:) separated list of translation options. Currently 
supported are no_version, dot_version, lower_case, and unix. 

freq isthe interval (in days) between dumps. For a PFS filesystem, thisshould beO. 

pass is thefsck(lM) pass in which to check the partition. For a PFS filesystem, this should beO. 

A pound-sign (#) as the first character indicates a comment line which is ignored by routines that read this 
file. The order of records in /etc/pfs_fstab is important because fsck, mount, and umount pro¬ 
cess the file sequentially: an entry for a file system must appear after the entry for any file system it is to 
be mounted on top of. 

EXAMPLES 

/dev/srO /cd-rom pfs-iso9660 ro,suid 0 0 
example:/hom^user /hom^user pfs-nfs ro,hard,fg 0 0 

AUTHOR 

pfs_fstab was developed by Young Minds, Inc. 
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FILES 

/etc/pfs_fstab 
/etc/mtab 

SEE ALSO 

pfs_mount(lM). 
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NAME 

portal - a "window tothefuture!' for applications 


SYNOPSIS 

#include <sys/portal.h> 


DESCRIPTION 

This header file is a "window to the future!' for applications. It will help you to: 

• Write code that is portable across 32-bit and 64-bit systems, 

• Avoid undocumented assumptions about sizes of integral types, 

• Write portable code that needs to be explicit about the sizes of integral types, 

• Write code that is portableto a platform which has different sizes of integral types, and 

• Share frequently used macros that are portable across 32-bit and 64-bit systems. 

In addition to the macros defined in this file, it includes the header files limits.h (see limits(5)) and 
inttypes . h (see i nttypes(5)). 

The foil owing macros are defined in sys/portal .h : 
set_mask_bit ( bit_num, type) 

This macro can be used to create a mask that has one bit set. bit_num is the position of the bit to set, 
and type is the data type of the mask. A -1 is returned in the case of overflow or underflow. 

set„mask_bit_loop (mask, bit_num, type) 

This macro can be used to set a bit in a mask, mask is the current value of the mask, bit_num is the 
position of the bit to set, and type is the data type of the mask. 

sign_bit (type) 

This macro can be used to return the bit position of the sign bit for the specified data type, type is the 
data type for which to return the position of the sign bit. 

SIGN_BIT_MASK (type) 

This macro can be used to return a mask for the sign bit for the specified data type, type is the data 
type for which to return the sign bit mask. 

sign_extend ( value, old_type, new_type) 

This macro can be used to do a sign extension from one data type to another, value is the current 
value that is to be sign-extended. old_type is the current data type of value and new_type is the new 
data type of value. 

test_endian( endian) 

This macro can be used to check if code has been compiled big or littleendian. endian is an integer in 
which the result will be returned. 


The following macros can be used for print formatting and scan formatting of values of data types that can 
change in size based upon the compilation flag _FILE_0FFSET_BITS. Examples of such data types are 
off_t and fpos_t. 


PRIdF64 

PRIOF64 

PRIxF64 

PRIuF64 


d print formatting option for a 32-bit or 64-bit size value, 

o print formatting option for a 32-bit or 64-bit size value, 

x print formatting option for a 32-bit or 64-bit size value, 

u print formatting option for a 32-bit or 64-bit size value. 


SCNdF64 

SCNOF64 

SCNxF64 

SCNuF64 


d scan formatting option for a 32-bit or 64-bit size value, 

o scan formatting option for a 32-bit or 64-bit size value, 

x scan formatting option for a 32-bit or 64-bit size value, 

u scan formatting option for a 32-bit or 64-bit size value. 


EXAMPLES 

The SET_MASK_BIT 


macro in the foil owing example will turn on the high bit in a 64-bit integer. 


SET_MASK_BIT(SIGN„BIT(int64_t), int64_t) 

The SET_MASK_BIT macro in the following example will be used to turn on all bits except the sign bit in 
a 32-bit integer. 


~SET_MASK„BIT(SIGN_BIT(int32_t), int32_t) 
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The SET_MASK_BIT_L00P macro in the following example will turn on the three least significant bits of 
the maximum integer. 

int i; 

intmax_t mask = 0; 

for (i = 0; i < 3; i++) { 

SET_MASK_BIT_LOOP(mask, i, intmax_t) ; 

} 

The SIGN BIT macro in the foil owing example will return the position of the sign bit in a 32-bit integer. 

SIGN BIT(int32_t) 

The SI GN_B I T_MAS K macro in the foil owing example will return a sign bit mask for a 32-bit integer. 

SIGN_BIT_MASK(int32_t) 

The SIGNJXTEND macro in the following example will convert the 8-bit integer stored in a char data 
type to a 64-bit integer and correctly extend the sign. 

char c; 
int64_t i; 

i = SIGN_EXTEND(c, char, int64_t); 

The TEST__ENDIAN macro in the following example will store a 1 in endian if the compilation was big 
endian; otherwise, it will store a 0 in endian. 

int endian; 

TEST_ENDIAN(endian); 
if (endian == 0) 

printf("This a little endian system\n"); 
if (endian == 1) 

printf("This a big endian system\n"); 

AUTHOR 

portal. h was developed by H P. 

FILES 

/usr/include/sys/portal.h 

SEE ALSO 

inttypes(5), limits(5), printf(3S), scanf(3S). 
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NAME 

quota - disk quotas 

DESCRIPTION 

Disk quotas can be used by the system administrator to limit the number of files and file blocks owned by a 
user on a per-fi I e-system basis. Separate limits can be established for both the number of files (inodes) and 
the number of 1-Kbyte blocks for each user. A soft (preferred) and a hard limit are established. 

For example, user joe_doe may have soft limits of 1000 blocks and 200 files and hard limits of 1200 
blocks and 300 files on the root file system (/) containing his/her HOME directory and /tmp, and soft and 
hard block limits of 100 and 120, respectively, with no explicit file limit (0), on the mounted file system 
/mnt. 

A time limit is established for each file system which determines how long a user is allowed to exceed the 
soft limit. The default time limit is one week (7 days). 

When a user exceeds his/her soft limit, a warning is emitted on the user's terminal. The user can continue 
to increase utilization over the soft limit until h^she either exceeds the hard limit or the established time 
limit. Once either of these events occurs, a message is sent to the user's terminal and further attempts at 
file creation and/or increased block utilization will fail. At this point, the user must reduce his/her use of 
the exceeded limit below the soft limit to restore normal operation. 

At login time, users exceeding quota limits are reminded (via login(l)) of exceeded quotas and appropriate 
remedial action. The user can check current quota status at any time with the quota command (see 
quota (1)). 

Quota limits and utilization statistics are maintained by the operating system for each file system for which 
quotas have been enabled (see mount(lM) and quotaon(lM)). 

Disk quotas are established independently for each user and each file system via the edquota command 
(see edquota(lM)). This command is also used to establish the limit for the amount of time users are per¬ 
mitted to exceed their soft limit. The default time limit is 1 week. 

Limits and usage statistics are stored statically in the file quotas on the root of each file system for which 
they are in effect. This file is synchronized with information in the kernel by the quotactl () system 
call (seequotactl(2)) and whenever an affected filesystem is unmounted. 

Quotas can be enabled automatically at boot or mount time by adding the quotas option to the option list 
in /etc/fstab (see fstab(4) and mount(lM)). By default, mount does not enable disk quotas. 

Quotas can subsequently be disabled and re-enabled with the quotaoff and quotaon commands (see 
quotaon(lM)). When quotas are disabled, the kernel does not maintain usage statistics and the quotas 
file usage statistics are invalidated by file system activity. Disabling quotas improves performance, but 
necessitates running the quotacheck command (see quotacheck(lM)) to update the kernel and quotas 
file after subsequently re-enabling quotas. 

The repquota command (see repquota(lM)) displays reports of current quota statistics. The somewhat 
related, but independent, quot command (see quot(lM)), collects and reports disk utilization indepen¬ 
dently of the disk quota subsystem. 

The mount command (see mount(lM)) reports any file systems for which quotas are enabled. 


Data Storage Structure 

The dqblk data structure (defined in <quota.h>), is used by the quotactl () system call (see quo¬ 
tactl (2)) to get or set quota information. This structure contains fields that are used to store a user's 
current fileand block count and quota limits for a particular file system. 


struct dqblk contains the foil owing members: 


u_long 

u_long 

u_long 

u_long 

u_long 

u_long 

u_long 

u_long 


dqb_bhardlimit; 
dqb_bsoftlimit; 
dqb_curblocks; 
dqb_fhardlimit; 
dqb_fsoftlimit; 
dqb_curflies; 
dqb_btimelimit; 
dqb_ftimelimit; 


/* maximum # of disk blocks +1 */ 

/* preferred limit on disk blocks */ 

/* current block count */ 

/* maximum # allocated files +1 */ 

/* preferred file limit */ 

/* current # allocated files */ 

/* time limit for excessive block use */ 
/* time limit for excessive files */ 
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NETWORKING FEATURES 

Quotas are not fully supported over NFS file systems. However, the quota command is able to report 
quota statistics on remote NFS file systems for which disk quotas are in effect, if the remote system pro¬ 
vides the RPC rquotad service (see rquotad(lM)). 

rquotad is provided to allow reciprocal support to other systems. 

EXAMPLES 
Initial Setup 

The kernel must be reconfigured to support disk quotas; see the System Administration manuals. Eligible 
file systems for disk quota enforcement are those with mount options rw and quota, as described in 
mount(lM) and fstab(4). 

For each file system for which quotas are to be enabled, perform thefollowingtasks: 

1. Mount the file system. 

2. Add quota to the existing options list in /etc/fstab. For example, change the string 
default for the root (/) entry to default, quota. Once this is done, quotas will automati¬ 
cally be enabled for all relevant file systems on system reboot. 

3. Create the quotas file in the mount directory of the file system. For example, for the /mnt 
file system, run the command 

cpset /dev/null /mnt/quotas 600 root bin 

4. Establish one or more prototype user quotas using theedquota command (see edquota(lM)). 

If you want a number of users on your system to have the same limits, use edquota to set 
those quotas for a prototype user; then use the edquota -p command to replicate those limits 
for that group of users. 

5. Turn on the quotas on thefilesystem using quotaon. For example, run thecommand 

/usr/sbin/quotaon /mnt 

6. Run quotacheck (see quotacheck(lM)) on the file system to record the current usage statis¬ 
tics. 

Adding a new user 

To add a new user to the quota system: 

1. Use edquota to copy the quotas of an existing user. 

2. Run quotacheck. 

Adding a new file system to an established system 

Repeat steps 1 through 5 above under "I nitial Setup" for the new file system. 

WARNINGS 

The fip-ux default is to allow chown(2). This can interfere with the disk quota mechanism. Quotas can be 
defeated ifthechown command (see chown(l)) or the chown () system call (seechown(2)) isaccessibleto 
a user. The setprivgrp command (see setprivgrp(lM)) can be used to limit access to the chown () sys¬ 
tem call so that only a specified group of users are permitted to use the chown command or the chown () 
system call. 

The sam command (see sam(lM)) does not yet support disk quotas. When adding new users or file sys¬ 
tems, any desired quotas must be established outside of sam. 

HP has added features to the original implementation to ensure correctness of the content of the quotas file 
when quotas are enabled by mount and disabled by umount (see mount(lM)), thus eliminating the need 
to run quotacheck (see quotacheck(lM)). These features are ineffective, however, if quotaoff and 
quotaon (see quotaon(1M)) are used to control quotas. 

quotacheck should only be run on a dormant file system to ensure accurate usage information. The 
-qv options of the fsclean command (see fsclean(lM)) report on the the current viability of the quota 
information. 

Currently, only hfs file systems support disk quotas, though there may be support for other file systems in 
the future. 
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AUTHOR 

Disk Quotas were developed by the University of California, Berkeley, Sun Microsystems, and HP. 

FILES 

/etc/fstab Static information about the file systems 

/etc/mnttab Mounted file system table 

directory /quotas Quota statistics static storage for afilesystem, where directory is the root of the file 
system, as specified to themount command (see mount(lM)). 

SEE ALSO 

chown(l), chown(2), quota(l), edquota(lM), fstab(4), mount(lM), quot(lM), quotacheck(lM), quotaon(lM), 
rquotad(lM), setprivgrp(lM), quotactl(2), vfsmount(2). 
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NAME 

rcsintro - description of RCS commands 

DESCRIPTION 

Revision Control System (RCS) automates the storing, retrieval, logging, identification, and merging of revi¬ 
sions of ascii text files. RCS is useful for managing files that are revised frequently. 

Functions of RCS 

• Storage and retrieval of revisions of text files. RCS saves revisions in a space efficient way. Revisions 
can be retrieved by ranges of revision numbers, symbolic names, dates, authors, and states. 

• Maintenance of a complete history of changes. RCS logs all changes automatically. In addition to the 
text of each revision, RCS stores the author, date and time of check in, and a log message summarizing 
the change. 

• Resolution of access conflicts. When two or more people try to modify the same revision of a file, RCS 
alerts them and prevents one modification from corrupting the other. 

• Maintenance of a tree of revisions. RCS can maintain separate lines of development for each file. It 
stores a tree structure that represents the ancestral relationships among revisions. 

• Merging of revisions and resolution of conflicts. Two separate lines of development of a file can be 
coalesced by merging. If the revisions to be merged affect the same lines of a file, RCS flags the overlap¬ 
ping changes. 

• Release and configuration control. Revisions can be assigned symbolic names and marked as released, 
stable, experimental, etc. With these facilities, configurations of a file can be described simply and 
directly. 

• Automatic identification of each revision with filename, revision number, creation time, author, etc. 
This identification is like a stamp that can be embedded at an appropriate place in thetext of a revision. 
These stamps make it simpleto determine which revisions of which files make up a given configuration. 

• Minimization of secondary storage. RCS uses very little extra space for revisions (only the differences 
are stored). If intermediate revisions are deleted, the remaining deltas arecompressed accordingly. 

Getting Started with RCS 

The basic user interface is extremely simple. The novice only needs to learn two commands: ci (1) and 
co(l). ci, short for "check in," deposits the contents of a text file into an archival file called an RCS file. An 
RCS file contains all revisions of a particular text file, co, short for "check out", retrieves revisions from an 
RCS file. 

Suppose you have a file f.c that you wish to put under control of RCS. Invoke the check in command: 

ci f.c 

This command creates the RCS file f.c,v, stores f.c into it as revision 1.1, and deletes f.c. It also asks you 
for a description. The description should be a synopsis of the contents of the file. All subsequent check-in 
commands will ask for a log entry, which should summarize the changes that were made. 

Files with names ending with ",v" are called RCS files ("v" stands for "versions"), all other files are presumed 
to be working files. To get back the working file f.c in the previous example, use the check out command: 

CO f.c 

This command extracts the latest revision from f.c,v and writes it into f.c. You can now edit f.c and check 
it back in by invoking: 

ci f.c 

ci increments the revision number properly. Ifci complains with the message: 

ci error: no lock set by <your Iogi n> 

your system administrator has decided to create all RCS files with the locking attribute set to "strict". In 
this case, you should have locked the revision during the previous check out. Your last check out should 
have been: 

CO -I f.c 

Of course, it is too late now to do the check out with locking, because you probably modified f.c already, and 
a second check out would overwrite your modifications. I nstead, invoke: 
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res -I f.c 

This command will lock the latest revision for you, unless somebody else has already locked it. In that 
case, you will have to negotiate with that person. 

Locking assures that you, and only you, can check in the next update, and avoids nasty problems if several 
people work on the same file. Even if a revision is locked, it can still bechecked out for reading, compiling, 
etc. All that locking prevents is a check in by anybody but the locker. 

If your rcs file is private, i.e., if you are the only person who is going to deposit revisions into it, strict lock¬ 
ing is not needed and you can turn it off. If strict locking is turned off, the owner of the RCS file need not 
have a lock for check in; all others still do. Turning strict locking off and on is done with the commands: 

rcs -U f.c 


and 


rcs -L f.c 

If you do not want to clutter your working directory with RCS files, create a subdirectory called RCS in your 
working directory, and move all your RCS files there. RCS commands will search that directory to find 
needed files. All the commands discussed above will still work without any modification. 

To avoid the deletion of the working file during check in (in case you want to continueediting), invoke: 

ci -I f.c 


or 


ci -u f.c 

These commands check in f.c as usual, but perform an implicit check out. The first form also locks the 
checked in revision, the second one does not. Thus, these options save you one check out operation. The 
first form is useful if locking is strict; the second one if not strict. Both update the identification markers in 
your working file (see below). 

You can give ci the number you want assigned to a checked in revision. Assume all your revisions were 
numbered 1.1, 1.2, 1.3, etc., and you would like to start release 2. The command: 

ci -r2 f.c 


or 


ci -r2.1 f.c 

assigns the number 2.1 to the new revision. From then on, ci will number the subsequent revisions with 
2.2, 2.3, etc. The corresponding co commands: 

co -r2 f.c 


and 


co -r2.1 f.c 

retrieve the latest revision numbered 2.x and the revision 2.1, respectively, co without a revision number 
selects the latest revision on the "trunk"; i.e., the highest revision with a number consisting of 2 fields. 
Numbers with more than 2 fields are needed for branches. For example, to start a branch at revision 1.3, 
invoke: 

ci -r 1.3.1 f.c 

This command starts a branch numbered 1 at revision 1.3, and assignsthe number 1.3.1.1 to the new revi¬ 
sion. For more information about branches, see rcsfile(4). 

RCS File Naming and Location 

RCS recognizes two kinds of files: RCS files (revision archives), and working files. Working filenames are 
defined by the RCS user, RCS file names are generated by RCS by appending ",v" to the working file name. 
Pairs of RCS files and working files can be specified in 3 ways: 

• Both the rcs file and the working file are given. The RCS filename is of the form 
pathl/workfile,v and the working filename is of the form path2/workfile, where pathl and 
path2 are (possibly different or empty) paths and workfile is a filename. 

• Only the rcs file is given. Then the working file is assumed to be in the current directory and its 
name is derived from the name of the RCS file by removing path!/ and the suffix ",v". 
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• Only the working file is given. Then the name of the RCS file is derived from the name of the 
working file by removing path2/ and appending the suffix ",v". 

If the RCS filename is omitted or specified without a path, RCS commands look for the RCS file in the direc¬ 
tory ./RCS (or the directory it points to if it is a directory link), then in the current working directory. 

RCS Directory Links 

RCS supports directory links. If a regular file named RCS exists in the current working directory, RCS inter¬ 
prets the first line as a path name to the directory where RCS files are stored. RCS can follow a chain of up 
to ten directory I inks to reach the RCS directory. 

Automatic Identification 

RCS can put special strings for identification into your source and object code. To obtain such identification, 
place the marker: 

$Header$ 

into your text, for instance inside a comment. RCS replaces this marker with a string of the form: 

$Header: filename revi si on_n umber date time author state$ 

With such a marker on the first page of each module, you can always see with which revision you are work¬ 
ing. RCS keeps the markers up-to-date automatically. To propagate the markers into your object code, sim¬ 
ply put them into literal character strings. I n C, this is done as follows: 

static char rcsid[] =$Header$ ; 

The command ident extracts such markers from any file, even object code and dumps. Thus, ident lets you 
find out which revisions of which modules were used in a given program. 

You may also find it useful to put the marker $Log$ into your text, inside a comment. This marker accu¬ 
mulates the log messages that are requested during check in. Thus, you can maintainthecomplete history 
of your file directly inside it. There are several additional identification markers. See co(l) for details. 

WARNINGS 

Names of RCS files are generated by appending ,v to the end of the working file name. If the resulting RCS 
file name is too long for the file system on which the RCS file should reside, the RCS command terminates 
with an error message. 

RCS is designed to be used with text files only. Attempting to use RCS with non-text (binary) files will 
result in data corruption. 

AUTHOR 

rcsintro was developed by Walter F. Tichy, Purdue University, West Lafayette, IN 47907. 

Revision Number: 3.0; Release Date: 83/05/11. 

Copyright 1982 by Walter F. Tichy. 

SEE ALSO 

ci(1), co(l), ident(l), merge(l), rcs(l), rcsdiff(l), rcsmerge(l), rlog(l), rcsfile(4). 

Walter F. Tichy, "Design, Implementation, and Evaluation of a Revision Control System," in Proceedings of 
the6th International Conferenceon Software Engineering, IEEE, Tokyo, Sept. 1982. 
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NAME 

regexp - regular expression and pattern matching notation definitions 

DESCRIPTION 

A regular expression is a mechanism supported by many utilities for locating and manipulating patterns 
in text, pattern matching notation is used by shells and other utilities for file name expansion. This 
manual entry defines two forms of regular expressions: Basic Regular Expressions and Extended Reg¬ 
ular Expressions; and the one form of Pattern Matching Notation. 

BASIC REGULAR EXPRESSIONS 

Basic regular expression (re) notation and construction rules apply to utilities defined as using basic REs. 
Any exceptions to the foil owing rules are noted in the descriptions of the specific utilities that use RES. 

REs Matching a Single Character 

The following REs match a single character or a single collating element: 

Ordinary Characters 

An ordinary character is an RE that matches itself. An ordinary character is any character in the sup¬ 
ported character set except <newline>and the regular expression special characters listed in Special Char¬ 
acters below. An ordinary character preceded by a backslash (\ ) is treated as the ordinary character itself, 
except when the character is (, ), { or J or the digits 1 through 9 (see REs Matching Multiple Characters). 
Matching is based on the bit pattern used for encoding the character; not on the graphic representation of 
the character. 

Special Characters 

A regular expression special character preceded by a backslash is a regular expression that matches the 
special character itself. When not preceded by a backslash, such characters have special meaning in the 
specification of REs. Regular expression special characters and the contexts in which they have special 
meaning are: 

.[\ 


$ 

delimiter 

Period 

A period (.), when used outside of a bracket expression, is an RE that matches any printableor nonprint- 
able character except <newline>. 

RE Bracket Expression 

A bracket expression enclosed in square brackets ([ ]) is an RE that matches a single collating element con¬ 
tained in the nonempty set of collating elements represented by the bracket expression. 

The foil owing rules apply to bracket expressions: 

bracket expression 

A bracket expression is either a matching list expression or a non-matching list 

expression, and consists of one or more expressions in any order. Expressions can 
be: collating elements, collating symbols, noncollating characters, equivalence classes, 
range expressions, or character classes. The right bracket (]) loses its special mean¬ 
ing and represents itself in a bracket expression if it occurs first in the list (after an 
initial ", if any). Otherwise, it terminates the bracket expression (unless it is the end¬ 
ing right bracket for a valid collating symbol, equivalence class, or character class, or 
it is the collating element within a collating symbol or equivalence class expression). 
The special characters 


The period, left square bracket, and backslash are special except when used in a 
bracket expression (see RE Bracket Expression). 

The asterisk is special except when used in a bracket expression, as the first character 
of a regular expression, or as the first character following the character pair \ ( (see 
REs Matching MultipleCharacters). 

The circumflex is special when used as the first character of an entire RE (see Expres¬ 
sion Anchoring) or as the first character of a bracket expression. 

The dollar sign is special when used as the last character of an entire RE (see Expres¬ 
sion Anchoring). 

Any character used to bound (i.e., delimit) an entireRE isspecial for that RE. 


Section 5-274 


- 1 - 


HP-UX Release 11.0: October 1997 


regexp(5) 


regexp(5) 


.* [\ 

(period, asterisk, left bracket, and backslash) lose their special meaning within a 
bracket expression. 

The character sequences: 

[. [= [: 

(left-bracket followed by a period, equal-sign or colon) are special inside a bracket 
expression and are used to delimit collating symbols, equivalence class expressions 
and character class expressions. These symbols must be followed by a valid expres¬ 
sion and the matching terminating .], =], or :]. 

matching list A matching list expression specifies a list that matches any one of the characters 
represented in the list. The first character in the list cannot be the circumflex. For 
example, [abc] is an RE that matches any of a, b, or c. 

non-matching list 

A non-matching list expression begins with a circumflex (“), and specifies a list that 
matches any character or collating element e<cept <newline> and the characters 
represented in the list. For example, [~abc] is an RE that matches any character 
except <newline>or a, b, or c. The circumflex has this special meaning only when it 
occurs first in the list, immediately following the left square bracket. 

collating element 

A collating element is a sequence of one or more characters that represents a single 
element in the collating sequence as identified via the most current setting of the 
locale category LC COLLATE (see setlocale(3C)). 

collating symbol 

A collatingsymbol is a collating element enclosed within bracket-period ([.]) del¬ 

imiters. Multi-character collating elements must be represented as collating symbols 
to distinguish them from single-character collating elements. For example, if the 
string ch is a valid collating element, then [[.ch.]] is treated as an element matching 
the same string of characters, while ch is treated as a simple list of the characters c 
and h. If the string within the bracket-period delimiters is not a valid collating ele¬ 
ment in the current collating sequence definition, the symbol is treated as an invalid 
expression. 

noncollating character 

A noncollating character is a character that is ignored for collating purposes. By 
definition, such characters cannot participate in equivalence classes or range expres¬ 
sions. 

equivalence class 

An equivalence class expression represents the set of collating elements belonging 
to an equivalence class. It is expressed by enclosing any one of the collating elements 
in the equivalence class within bracket-equal ([=...=]) delimiters. For example, if a, 
a, and A belong to the same equivalence class, then [[=a=]b], [[=a=]b], and [[^\=]b] 
are each equivalent to [aaAb], 

range expression 

A range expression represents the set of collating elements that fall between two 
elements in the current collation sequence as defined via the most current setting of 
the locale category LC_COLLATE (see setlocale(3C)). It is expressed as the starting 
point and the ending point separated by a hyphen (-). 

The starting range point and the ending range point must be a collating element, col¬ 
lating symbol, or equivalence class expression. An equivalence class e<pression used 
as an end point of a range expression is interpreted such that all collating elements 
within the equivalence class are included in the range. For example, if the collating 
order is A, a, B, b, C, c, ch, D, and d and the characters A and a belong to the same 
equivalence class, then the expression [[^=]-D] is treated as [AaBbCc[.ch.]D], 

Both starting and ending range points must be valid collating elements, collating sym¬ 
bols, or equivalence class expressions, and the ending range point must collate equal 
to or higher than the starting range point; otherwise the expression is invalid. For 
example, with the above collating order and assuming that E is a noncollating 
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character, then both the expressions [[=A=]-E] and [d-a] are invalid. 

An ending range point can also be the starting range point in a subsequent range 
expression. Each such range expression is evaluated separately. For example, the 
bracket expression [a-m-o] is treated as [a-mm-o]. 

The hyphen character is treated as itself if it occurs first (after an initial ", if any) or 
last in the list, or as the rightmost symbol in a range expression. As examples, the 
expressions [-ac] and [ac-] are equivalent and match any of the characters a, c, or 
the expressions [“-ac] and [“ac-j are equivalent and match any characters except 
<newline>, a, c, or the expression [%--] matches any of the characters in the defined 
collating sequence between % and - inclusive; the expression [--(§i| matches any of the 
characters in the defined collating sequence between - and ©inclusive; and the expres¬ 
sion [a--@| is invalid, assuming - precedes a in the collating sequence. 

If a bracket expression must specify both - and ], the ] must be placed first (after the", 
if any) and the - last within the bracket expression. 

character class 

A character class expression represents the set of characters belonging to a character 
class, as defined via the most current setting of the locale category LC CTYPE. It is 
expressed as a character class name enclosed within bracket-colon ([::]) delimiters. 

Standard character class expressions supported in all locales are: 


[:alpha:] 

letters 

[:upper:] 

upper-case letters 

[:lower:] 

lower-case letters 

[:digit:] 

decimal digits 

[:xdi git:] 

hexadecimal digits 

[:alnum:] 

letters or decimal digits 

[:space:] 

characters producing white-space in displayed text 

[:print:] 

printing characters 

[:punct:] 

punctuation characters 

[:graph:] 

characters with a visible representation 

[:cntrl:] 

control characters 

[:blank:] 

blank characters 


RES Matching Multiple Characters 

The foil owing rules may be used to construct REs matching multiple characters from REs matching a single 
character: 

RE RE 


RE* 


\(RE\) 
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The concatenation of REs is an RE that matches the first encountered concatenation 
of the strings matched by each component of the RE. For example, the RE be 
matches the second and third characters of the string abedefabedef. 

An RE matching a single character followed by an asterisk (*) is an RE that matches 
zero or more occurrences of the RE preceding the asterisk. The first encountered 
string that permits a match is chosen, and the matched string will encompass the 
maximum number of characters permitted by the RE. For example, in the string 
abbbcdeabbbbbbcde, both the RE b*c and the RE bbb*c are matched by the sub¬ 
string bbbe in the second through fifth positions. An asterisk asthefirst character of 
an RE loses this special meaning and is treated as itself. 

A subexpression can be defined within an RE by enclosing it between the character 
pairs \( and \). Such a subexpression matches whatever it would have matched 
without the\ ( and \). Subexpressions can be arbitrarily nested. An asterisk immedi¬ 
ately following the \( loses its special meaning and is treated as itself. An asterisk 
immediately following the\) is treated as an invalid character. 

The expression \ n matches the same string of characters as was matched by a subex¬ 
pression enclosed between \( and \) preceding the \n. The character n must be a 
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digitfrom lthrough 9, specifying the n-th subexpression (the one that begins with the 
n-th \( and ends with the corresponding paired \). For example, the expression 
'A [f\ )\ 1 $ matches a line consisting of two adjacent appearances of the same string. 

If the\ n is followed by an asterisk, it matches zero or more occurrences of the subex¬ 
pression referred to. For example, the expression \ (ab\ (cd\ )ef\ )Z\ 2*Z\ 1 matches 
the string abcdefZcdcdZabcdef. 

REX {m,n\ } An RE matching a single character followed by \ {m\ } \ -fnA } or \ -fn,n\ }is an RE 
that matches repeated occurrences of the RE. The values of m and n must be decimal 
integers in the range 0 through 255, with m specifying the exact or minimum number 
of occurrences and n specifying the maximum number of occurrences. \ -fnX }matches 
exactly m occurrences of the preceding RE, \ {m,\ } matches at least m occurrences, 
and \ {m,n\ }matches any number of occurrences between m and n, inclusive. 

The first encountered string that matches the expression is chosen; it will contain as 
many occurrences of the RE as possible. For example, in the string abbbbbbbc the 
RE b\ -0\ }is matched by characters two through four, the RE b\ -PA } is matched by 
characters two through eight, and the RE b\ p,5\ ]c is matched by characters four 
through nine. 

Expression Anchoring 

An RE can be limited to matching strings that begin or end a line (i.e., anchored) according to the following 
rules: 

• A circumflex (") as the first character of an RE anchors the expression to the beginning of a line; 
only strings starting at the first character of a line are matched by the RE. For example, the RE 
''abmatches the string ab in the line abcdef, but not the same string in the line cdefab. 

• A dollar sign ($) as the last character of an RE anchors the expression to the end of a line; only 
strings ending at the last character of a line are matched by the RE. For example, the RE ab$ 
matches the string ab in the line cdefab, but not the same string in the line abcdef. 

• An RE anchored by both " and $ matches only strings that are lines. For example, the RE 
^abcdef $matches only lines consisting of the string abcdef. 

The use of duplication characters (+,*) following anchors is illegal. 

EXTENDED REGULAR EXPRESSIONS 

The extended regular expression (ere) notation and construction rules apply to utilities defined as using 
extended REs. Any exceptions to the foil owing rules are noted in the descriptions of the specific utilities using ERES. 

EREs Matching a Single Character 

The following EREs match a single character or a single collating element: 

Ordinary Characters 

An ordinary character is an ERE that matches itself. An ordinary character is any character in the sup¬ 
ported character set except <newline>and the regular expression special characters listed in Special Char¬ 
acters below. An ordinary character preceded by a backslash (\) is treated as the ordinary character itself. 
Matching is based on the bit pattern used for encoding the character, not on the graphic representation of 
the character. 

Special Characters 

A regular expression special character preceded by a backslash is a regular expression that matches the 
special character itself. When not preceded by a backslash, such characters have special meaning in the 
specification of EREs. The extended regular expression special characters and the contexts in which they 
have their special meaning are: 

■ [ \ ()*+?$ | The period, left square bracket, backslash, left parenthesis, right parenthesis, aster¬ 
isk, plus sign, question mark, dollar sign, and vertical bar are special except when 
used in a bracket expression (see ERE Bracket Expression). 

~ The circumflex is special except when used in a bracket expression in a non-leading 

position. 

delimiter Any character used to bound (i.e., delimit) an entireERE isspecial for that ERE. 
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Period 

A period (.), when used outside of a bracket expression, is an ERE that matches any printableor nonprint- 
able character except <newline>. 

ERE Bracket Expression 

The syntax and rules for ERE bracket expressions are the same as for RE bracket expressions found above. 

EREs Matching Multiple Characters 

The following rules may be used to construct EREs matching multiple characters from EREs matching a 


single character: 


RE RE 

A concatenation of EREs matches the first encountered concatenation of the strings 
matched by each component of the ERE. Such a concatenation of EREs enclosed in 
parentheses matches whatever the concatenation without the parentheses matches. 
For example, both the ERE be and the ERE (be) matches the second and third char¬ 
acters of the string abedefabedef. The longest overall string is matched. 

RE + 

The special character plus (+), when following an ERE matchinga singlecharacter, or 
a concatenation of EREsenclosed in parenthesis, isan ERE that matches one or more 
occurrences of the ERE preceding the plus sign. The string matched will contain as 
many occurrences as possible. For example, theERE b+c matches the fourth through 
seventh characters in the string acabbbcde. 

RE* 

The special character asterisk (*), when following an ERE matchinga single charac¬ 
ter, or a concatenation of EREs enclosed in parenthesis, is an ERE that matches zero 
or more occurrences of the ERE preceding the asterisk. For example, the ERE b*c 
matches the first character in the string cabbbcde. If there is any choice, the longest 
left-most string that permits a match is chosen. For example, theERE b*cd matches 
the third through seventh characters in the string cabbbcdebbbbbbcdbc. 

RE? 

The special character question mark (?), when following an ERE matching a single 
character, or a concatenation of EREs enclosed in parenthesis, is an ERE that 
matches zero or one occurrences of the ERE preceding the question mark. The string 
matched will contain as many occurrences as possible. For example, the ERE b?c 
matches the second character in the string acabbbcde. 

RE {m,n} 

interval expression that functions the same way as basic regular expression syntax, 
RE\|n,n\} 

Alternation 

Two EREs separated by the special character vertical bar (| ) matches a string that is matched by either 
ERE. For example, the ERE ((ab)| c)d matches the string abd and the stringed. 

Precedence 

The order of precedence is as follows, from high to low: 

[] 

square brackets 

* +? 

asterisk, plus sign, question mark 

1 

anchoring 

concatenation 

alternation 


For example, the ERE abba| cde is interpreted as "match either abba or cde. It does not mean "match 
abb followed by a or c followed in turn by de (becauseconcatenation has a higher order of precedence than 
alternation). 


Expression Anchoring 

An ERE can be limited to matching strings that begin or end a line (i.e., anchored) according to the follow¬ 
ing rules: 

• A circumflex (') matches the beginning of a line (anchors the expression to the beginning of a line). 
For example, the ERE “ab matches the string ab in the line abcdef, but not the same string in the 

linecdefab. 
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• A dollar sign ($) matches the end of a line (anchors the expression to the end of a line). For exam¬ 
ple, the ERE ab$ matches the string ab in the line cdefab, but not the same string in the line 

abcdef. 

• An ERE anchored by both " and $ matches only strings that are lines. For example, the ERE 
''abcdef $matches only lines consisting of the string abcdef. Only empty lines match the ERE “$. 

The use of duplication characters (+,*) following anchors is illegal. 

PATTERN MATCHING NOTATION 

The following rules apply to pattern matching notation except as noted in the descriptions of the specific 
utilities using pattern matching. 

Patterns Matching a Single Character 

The following patterns match a single character or a single collating element: 

Ordinary Characters 

An ordinary character is a pattern that matches itself. An ordinary character is any character in the sup¬ 
ported character set except <newline>and the pattern matching special characters listed in Special Charac¬ 
ters below. Matching is based on the bit pattern used for encoding the character, not on the graphic 
representation of the character. 

Special Characters 

A pattern matching special character preceded by a backslash (\ ) is a pattern that matches the special 
character itself. When not preceded by a backslash, such characters have special meaning in the 
specification of patterns. The pattern matching special characters and the contexts in which they have 
their special meaning are: 

? * [ The question mark, asterisk, and left square bracket are special except when used in a 

bracket expression (see Pattern Bracket Expression). 


Question Mark 

A question mark (?), when used outside of a bracket expression, is a pattern that matches any printableor 
nonprintablecharacter except <newline>. 

Pattern Bracket Expression 

The syntax and rules for pattern bracket expressions are the same as for RE bracket expressions found 
above with thefollowing exceptions: 

The exclamation point character (!) replaces the circumflex character (") in its role in a non-matching 
list in the regular expression notation. 

The backslash is used as an escape character within bracket expressions. 

Patterns Matching Multiple Characters 

The following rules may be used to construct patterns matching multiple characters from patterns match¬ 
ing a single character: 

* The asterisk (*) is a pattern that matches any string, including the null string. 

RE RE The concatenation of patterns matching a single character is a valid pattern that 

matches the concatenation of the single characters or collating elements matched by 
each of the concatenated patterns. For example, the pattern a[bc] matches the string 

ab and ac. 

The concatenation of one or more patterns matching a single character with one or 
more asterisks is a valid pattern. I n such patterns, each asterisk matches a string of 
zero or more characters, up to thefirst character that matches the character following 
the asterisk in the pattern. 

For example, the pattern a*d matches the strings ad, abd, and abed; but not the 
string abc. When an asterisk is the first or last character in a pattern, it matches 
zero or more characters that precede or follow the characters matched by the 
remainder of the pattern. For example, the pattern a*d* matches the strings ad, 
abed, abcdef, aaaad, and adddd; the pattern *a*d matches the strings ad, abed, 
efabed, aaaad, and adddd. 
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Rule Qualification for Patterns Used for Filename Expansion 

The rules described above for pattern matching are qualified by the following rules when the pattern 
matching notation is used for filename expansion by sh(l), csh(l), ksh(l), and make(l). 

If a filename (including the component of a pathname that follows the slash (/) character) begins with 
a period (.), the period must be explicitly matched by using a period asthefirst character of the pat¬ 
tern; it cannot be matched by either the asterisk special character, the question mark special charac¬ 
ter, or a bracket expression. This rule does not apply to make(l). 

The slash character in a pathname must be explicitly matched by using a slash in the pattern; it can¬ 
not be matched by either the asterisk special character, the question mark special character, or a 
bracket expression. For make(l) only the part of the pathname following the last slash character can 
be matched by a special character. That is, all special characters preceding the last slash character 
lose their special meaning. 

Specified patterns are matched against existing filenames and pathnames, as appropriate. If the pat¬ 
tern matches any existing filenames or pathnames, the pattern is replaced with those filenames and 
pathnames, sorted according to the collating sequence in effect. If the pattern does not match any 
existing filenames or pathnames, the pattern string is left unchanged. 

If the pattern begins with a tilde (") character, all of the ordinary characters preceding the first slash 
(or all characters if there is no slash) are treated as a possible login name. If the login name is null 
(i.e., the pattern contains only the tilde or the tilde is immediately followed by a slash), the tilde is 
replaced by a pathname of the process's home directory, followed by a slash. Otherwise, the combina¬ 
tion of tilde and login name are replaced by a pathname of the home directory associated with the 
login name, followed by a slash. If the system cannot identify the login name, the result is 
implementation-defined. This rule does not apply to sh(l) or make(l). 

If the pattern contains a $ character, variable substitution can take place. Environmental variables 
can be embedded within patterns as: 

$name 


or: 


${name} 

Braces are used to guarantee that characters following name are not interpreted as belonging to 
name. Substitution occurs in the order specified only once; that is, the resulting string is not exam¬ 
ined againfor new names that occurred because of the substitution. 

Rule Qualification for Patterns Used in the case Command 

The rules described above for pattern matching are qualified by the following rule when the pattern match¬ 
ing notation is used in the case command of sh(l) and ksh(l). 

Multiplealternative patterns in a single clause can be specified by separating individual patterns with 
the vertical bar character (| ); strings matching any of the patterns separated this way will cause the 
corresponding command list to be selected. 

SEE ALSO 

ksh(l), sh(l), fnmatch(3C), glob(3C), regcomp(3C), setlocale(3C), environ(5). 

STANDARDS CONFORMANCE 

<regexp.h>: AES, SVID2, SVID3, XPG2, XPG3, XPG4 
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NAME 

sd - create, distribute, install, monitor, and manage software 

SYNOPSIS 

sw<task> [XToolkit Options] [— r | -d] [— i ] [-1] [-p] [-R] [-u] [-v] [-V] 

[-a attribute] [-c catalog] [-C session_file] [-D ad_entry] [-f software_file] [-F ad_file] 
[-J jobid] [-1 lei/el ] [-M ad entry] [-Q date] [-s source] [-S session file] 

[-t target_file] [-x option=value] [-X option_fiIe] [software_selections] [@ target_selections] 


Remarks 

• HP-UX's software distributor, SD-UX, is included with the HP-UX Operating System and 
manages software on the local host only. 

• To install and manage software simultaneously on multiple remote hosts (including HP-UX, other 
UNIX® platforms, Windows NT®, and PCs) from a central controller, you must purchase the HP 
OpenView Software Distributor which provides extended software management capabilities. I nfor- 
mation specific only to the OpenView product is marked with a heading similar to the following: 

Thefollowing information applies to HP OpenView Software Distributor only. 


DESCRIPTION 

The SD commands are: 

• sd - create and monitor softwarejobs (HP OpenView Software Distributor only). 

• swacl - modify the Access Control Lists (ACLs) which protect software products. 

• swagentd - serve local or remote SD software management tasks. 

• swask - ask for a user response. 

• swcluster - configure diskless clients (H P-UX 10* only). 

• swconfig - configure, unconfigure, or reconfigure installed software. 

• swcopy - copy software products for subsequent installation or distribution. 

• swgettools - retrieve the SD product from new media. 

• swinstall - install and configure software products. 

• swjob - monitor job progress and log files. (HP OpenView Software Distributor only). 

• swlist - display information about software products. 

• swmodify - modify software product information in a target root or depot. 

• swpackage - package software products into a distribution directory or tape. 

• swreg - register or unregister depots or roots. 

• swremove - unconfigure and remove software products. 

• swverify - verify software products. 

Related commands include: 

• mk_kernel - build a bootable HP-UX kernel (HP-UX only). 

• pushAgent - install the HP OpenView Software Distributor agent on remote systems. 
Thefollowing sections highlight the features that these commands support. 

I nteractive Operation 

By default, all SD commands except swask operate in a non-interactive mode. However, swcopy, swin¬ 
stall, swlist, and swremove commands also support a graphical user interface (GUI). To invokethe 
GUIs, enter the command without any command-line options or use the -i option. 

The command-1 ineversions of swinstall and swconfig can be interactive if the ask option is set to 
true. 
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Thefollowing information applies to HP OpenView Software Distributor only. 

To invoke the HP OpenView Software Distributor GUI, use sd command. This provides the central interac¬ 
tive interface for creating and monitoring softwarejobs. 

Distributed Operation 

All of the commands except swask, swpackage, and swmodify use a distributed model of operation. 
The commands act as the controller for distributed operations, managing the specific software management 
tasks. For each target_selection, an SD agent process performs the task: 

• swagent - perform software management tasks as the agent of an SD command. 

Communication between the command and each agent, plus other target host activities are facilitated by an 
SD daemon process: 

• swagentd - serve local or remote software management tasks. 

Thefollowing PC information applies onlyto HP OpenView Software Distributor. 

For each PC controller target_selection, a single Windows application combines the swagent and 
swagentd functionality: 

• SWAGENTD.EXE - perform software management tasks, serve local PC software for distribu¬ 
tion. 

Each PC running the SWAGENTD.EXE is a PC controller. When distributing PC software, it acts as a 
fanout server to PC targets. These targets run SD PC agent programs to perform the actual software ins¬ 
tallation tasks. 

SoftwareJ ob Management 

Thefollowing paragraph applies only to HP OpenView Software Distributor. 

Most SD commands create job information that records the job definition (in a session file), status and log 
information for the job. J obs can be executed immediately, or scheduled for later execution. The user can 
browse the scheduled, active, and completed jobs using either the command line or interactive interfaces. 

Secure Operation 

SD uses Access Control Lists (ACLs) to authorizea user attempting to create, modify, or read software pro¬ 
ducts in a depot or installed to a root file system. The superuser can grant specific local and remote users 
specific access permissions to a target host, a target depot, and/or a target root file system. 

Because files are loaded and scripts are run as superuser, granting write permission (to install software) on 
a root file system or insert permission (to create a new root) on a host, effectively gives the user superuser 
privileges. 

SD uses a method based on credentials and passwords to authenticate the user and the SD command per¬ 
forming a given operation. 

Flexible Policy Control 

Many policies and behaviors for the SD commands can be controlled via the appropriate command options. 
Options can be defined in an SD defaults file, specified on the command-line invocation of a command, or 
specified in the GUI. 

Preview, Diagnostics and Logging 

All commands except swlist and swjob log major events on the controller host and detailed events on 
the target hosts. 

If both source and target machine are updated to HP-UX version 10.30 or later, the system administrator 
at the source depot machine can track which user pulls which software from a depot on the source machine 
and when the software is pulled. Refer to the swagent(lM) source_depot_audit option for more 
information. 

Thefollowing paragraph applies onlyto HP OpenView Software Distributor. 

You can use the SD interactive interface (invoked using the sd command) and the swjob command line 
interface to monitor job progress and to view controller and target log files. 

Theswconfig, swcopy, swinstall, swmodify, swpackage, and swremove commands support 
a preview mode, where the commands will proceed through the analysis phase, then exit. 
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The preview mode only applies to non-interactive operations, since the GUIs wait for confirmation after 
analysis. In the interactive mode, you can resolve invalid conditions that the commands discover before 
they actually begin loading or removing files. 

Software Products 

Software products are organized in a multi-level hierarchy: bundles, products, subproducts, and filesets. 
The actual files that make up a product are packaged into filesets. The software_selections for an SD com¬ 
mand can specify bundles, products, individual subproducts, and/or individual filesets. 

Compatible Software 

Software products specify what machine types and operating systems they support (i.e. are compatible 
with). The swconfig, swinstall, and swverify commands can detect and/or enforce the use of 
compati bl e software. 

Dependencies Between Software 

Theswask, swconfig, swcopy, swinstall, swremove, and swverify commands support depen¬ 
dencies between filesets and other filesets and products. 

If a software_selection specifies a dependency on other filesets and/or products, the commands will automat¬ 
ically select that software. An exception is swremove, which can automatically select dependent software 
(filesets and/or products that depend on the software_selections). 

By default, all dependencies must be resolved before a command will proceed. The user can override this 
policy using the enforce_dependencies option. 

SD supports two types of dependencies: prerequisites that must be installed and configured before the 
dependent fileset is installed and configured (respectively): and corequisites that must be installed and 
configured before the dependent is usable.. 

Product Location and Multiple Versions 

The swinstall command can install a software product to an alternate product location instead of the 
default product directory specified by the vendor. (This directory location is the root directory of all the 
product's files.) 

The swinstall command can also install multiple versions of a software product to a single target sys¬ 
tem, each in a unique product location. 

The software management commands, swconfig, swlist, swremove, and swverify allow a user to 
select a specific product from the multiple installed versions by specifying the product location as part of 
the software_sel ecti on. 

Alternate Root Directory and Depot Directory 

By default, the swinstall, swlist, swverify, and swremove commands operate on the primary 
root file system of a target host, namely "/". The user can specify an alternate root directory to these com¬ 
mands, meaning a directory other than "/" that will eventually be the root of some target host (e.g. building 
a test system by mounting its root filesystem). 

The swconfig command only operates on software installed to the primary root filesystem,"/". 

When operating on a depot, the swpackage, swcopy, swlist, swverify, and swremove com¬ 
mands by default use the depot located at /var/spool/sw. The user can also specify an alternate depot 
directory to these commands. 

Disk Space Analysis 

The swcopy, swinstall, and swpackage commands perform a disk space analysis on the 
target_selections to ensure that enough free disk space is availableto perform the task. 

Before performing any disk space analysis, these commands (and also swverify and swremove) exe¬ 
cute the mount(lM) command to mount all file systems listed in each target's file system table 
(/etc/fstab or equivalent). This ensures that files are not loaded into a directory below a future mount 
point. The user can override this mounting policy using the mount_all_filesystems option. 
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Control Scripts 

The swask, swconfig, swinstall, swremove, and swverify commands execute vendor-defined 
control scripts to perform checks and/or other tasks beyond those explicitly performed by the commands. 

The swask command can run request scripts to request user responses. The swinstall and swcon¬ 
fig commands can also run request scripts. 

For swinstall and swremove, a fileset and/or product can include a check script to perform an 
analysis of each target_selection (target host). If this analysis fails, the script can: prevent the 
fileset/product from being installed/removed or abort the entire session. 

In addition, swinstall and swremove can execute scripts immediately before and immediately after 
the fileset/product has been installed or removed. These scripts usually perform additional file install or 
remove operations. 

The swconfig, swinstall, and swremove commands will also execute configuration and 
unconfiguration scripts on an installed fileset/product to configure or unconfigure the system for the 
software. 

The swverify command will execute a verification script which can analyze the configured 
fileset/product to verify that it is configured properly. 

Software States 

The SD commands transition products and filesets through a number of states. 

During installation, software is transitioned through the following states: non-existent, TRANSIENT, 
INSTALLED, and CONFIGURED. During removal, software is transitioned through these states: CON¬ 
FIGURED, INSTALLED, TRANSIENT, and non-existent. 

When packaging or copying software into a depot, the software is transitioned through the foil owing states: 
non-existent, TRAN SI ENT, and AVAILABLE. When removing software from a depot, the software is tran¬ 
sitioned through these states: AVAI LABLE, TRANSI ENT, and non-existent. 

If a task fails during any TRANSI ENT state, the state is set to CORRUPT. 

Session Files 

Each invocation of an SD command defines a task session. Most SD commands automatically save options, 
source information, software selections, and target selections before the task actually commences. You can 
build, save, and reuse additional sessions with most commands. 

Software and Target Lists 

Most SD commands support software and target selections from separate input files. You can reuse files 
containing sets of software or target configurations as input to the commands. 

Options 

The following options are supported by one or more of the SD commands. Refer to the manual pages for 
each command for the options specific to that command. 

XToolKit Options 

The interactive commands support a subset of the standard X Toolkit options to control the 
appearance of the GUI . The supported options are: -bg, -background, -fg, -fore¬ 
ground, -display, -name, -xrm. and -synchronous. SeetheX(l) manual page 
for a definition of these options. 

-d Causes the command to operate on target_selections which are software depots rather than 

root directories. 

-r (Optional) Causes the command to operate on target_selections that are alternate root 

directories (root file systems other than /). 

Note that you cannot use this option to relocate software during installation. You must use 
the l=location syntax in the software selection component. 

-i Runs the command in interactive mode (Graphical User I nterface). 
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-1 (HP-UX 10* only) Runs the command in linkinstall mode, which makes software installed 

under a server's shared root availableto a diskless client's private root. 

When run in linkinstall mode, swinstall: 

• Creates NFS mounts to the software to make it accessible from the target. This may 
involve delayed mounting for alternate roots. 

• Modifies the target's fstab file. 

• Modifies the source's exports fileto add mount permission for thetarget. 

Mounts are created by examining the share_link product attribute. Not all products sup¬ 
port linkinstall . Some products may be visible without creating a new mount if they 
reside under an existing one. 

-p Previews the task by executing the session through the analysis phase and exiting before 

the command begins to perform the actual task. This option only appliesto non-interactive 
sessi ons. 

-R Recursively include all objects to the fileset level using swlist, (and to the end_target 

level using the HP OpenView Software Distributor swjob command). 

-u Undo variation of the operation, unconfiguring software using swconfig, unregistering 

the specified objects using swreg, (or removing the specified jobs using the HP OpenView 
Software Distributor swjob command). 

-v Turns on verbose output to stdout. (The command log file is not affected by this option.) 
By default, verbose output is enabled for all theSD commands. 

-V List the SDU data model revisions that swpackage supports. 

-a attribute 

Specifies particular attributes to display or modify using swlist, swmodify, (ortheHP 
OpenView Software Distributor swjob command). 

-c catalog 

Specifies the pathname of an exported catalog which stores copies of the response files 
created by request scripts. 

-C session_file 

Save the current options and operands to session_file. You can enter a relative or absolute 
path with the file name. The default directory for session files is 
$HOME/ . sw/sessions/. You can recall a session file with the -S session file option. 
From an interactive session, you can save session information into a file at any time with 
the Fil^Save Session or File/Save Session As option. You can save session information 
from a command-line session with the -C session_file option. In addition, each command 
automatically creates a session file of the most recent session information and names the 
file $HOME/ . sw/sessions/sw<task> . last. 

-D acl entry 

Deletes an existing entry from the ACL associated with the specified objects using swacl. 
-f software_file 

Read the list of selections from software_file instead of (or in addition to) the command line 
operands. 

-F acl file 

Assigns the ACL contained in ad_fileto the specified object using swacl. 

-J job id 

(HP OpenView Software Distributor only) Executes the previously scheduled job. This 
option is used by the swagentd to initiatescheduled jobs. 

-1 lei/el List all objects at the specified lei/el when using swlist, or define the level of the objects 
when using swacl, or swreg. 

-M acl entry 

Adds a new ACL entry or changes the permissions of an existing entry using swacl. 

-Q date (HP OpenView Software Distributor only) Schedules the command for the specified date 
and time. 
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-s source 

Specifies source depot, PSF file, or tape from which software will be installed, copied, listed, 
or packaged. 

-S session_file 

Execute swinstall or swcopy based on the options and operands saved from a previ¬ 
ous session, as defined in session_file. You can save session information to a file with the 
-C session_fileoption. 

-t target_file 

Read the list of target_selections from target_file instead of (or in addition to) the command 
line operands. 

-x option=value 

Set the session option to value and override the default value (or a value in an alternate 
option_file specified with the -X option). Multiple -x options can be specified. 

-X option file 

Read the session options and behaviors from option_file. These values defined in this file 
override the default values. 


Operands 

Most SD commands support two types of operands: software selections followed by target selections. These 
operands are separated by the "(§)' (at) character. This syntax implies that the command operates on "selec¬ 
tions at targets". 

Software Selections 

The selections operands consist of software_selections for most SD commands. For the swjob (FHP Open- 
View Software Distributor) and swreg commands, the selections can be jobjds and roots_or_depots 
respectively. 

TheSD commands support the foil owing syntax for each software_selection: 
bundle[. product[. subproduct][. fileset]][, version] 
product[. subproduct][. fi I eset][, version] 

The version component has the form: 

[,r <op> ra/ision][,a <op> arch][,v <op> vendor] 

[, c <op> category][, 1= location][, fr <op> revision] 

[, fa <op> arch] 

• location applies only to installed software and refers to software installed to a location other than 
the default product directory. 

• fr and fa apply only to filesets. 

• The <op> (relational operator) component can be of the form: 

==, >=, <=, <, >, or ! = 

which performs individual comparisons on dot-separated fields. 

For example, r>=B.10.00 chooses all revisions greater than or equal to B. 10.00. The sys¬ 
tem compares each dot-separated field to find matches. Shell patterns are not allowed with these 
operators. 

• The = (equals) relational operator lets you specify selections for swlist, swpackage, and 
swmodify with thefollowing shell wildcard and pattern-matching notations: 

[ ],*,?,! 

For example, the expression r=l [01] . * returns any revision in version 10 or version 11. 

• All version components are repeatable within a single specification (eg. r>=A. 12, r<A. 20). 
If multiple components are used, the selection must match all components. 

• Fully qualified software specs include the r=, a=, and v= version components even if they con¬ 
tain empty strings. 

• No space or tab characters are allowed in a software selection. 
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• The software instancejd can takethe place of the version component. It hastheform: 

[instancejd] 

within the context of an exported catalog, where instancejd is an integer that distinguishes ver¬ 
sions of products and bundles with the same tag. 

The * software specification selects all products. It is not allowed when removing software from the root 
directory (/). 

Target Selections 

The SD commands support this syntax for each target_selection. 

[host][: ][/di rectory] 

The : (colon) is required if both a host and directory are specified. 

Thefollowing PC information applies onlyto HP OpenView Software Distributor. 

The swinstall and swjob commands support thefollowingsyntaxfor specifying PCs: 

[pc_controller][: : ][pc_targdt] 

• The PC controller is a fanout server. 

• The PC target may be a PC machine, user, or group name. 

• Valid targets for a PC controller can be listed using: 
swlist -1 machine|user|group 

PC targets can be further qualified for whether they refer to a PC machine, user, or group type with thefol¬ 
lowing syntax: 

name[, t=type][ , k=address] 

• The type must be specified when a name applies to more than one of a machine, user, or 
group. (The address is used internally for machines and is generally not needed on the com¬ 
mand line.) 

• The keyword * can be substituted for pc_target, specifying an installation to all target 
machines: 

@ pc_controller::* 

EXTERNAL INPUTS AND INFLUENCES 
Default Options 

In addition to the standard options, several SD behaviors and policy options can be changed by editing the 
default values found in: 

/var/adm/sw/defaults the system-wide default values. 

$HOME/ . swdef aults the user-specific default values. 

Values must be specified in the defaults file using this syntax: 

[command_name. ]option=value 

The optional command_name prefix denotes one of the SD commands. Using the prefix limits the changein 
the default value to that command. If you leave the prefix off, the change applies to all commands. 

You can also override default values from the command line with the -x or -X options: 
command -x option=value 
command -X option_file 

Thefollowing section lists all of the keywords supported by the SD commands. The keywords that are sup¬ 
ported for individual commands are also listed in each command's manual page. If a default value exists, it 
is listed after the "=". The commands that this option applies to are also specified. 

agent=/usr/lbin/swagent 

The location of the agent program invoked by the daemon. 

Applies to swagentd. 


HP-UX Release 11.0: October 1997 


-7- 


Section 5-287 


sd(5) 


(Hewlett-Packard Company) 


sd(5) 


agent_auto_exit=t rue 

Causes the target agent to automatically exit after Execute phase, or after a failed Analysis 
phase. This is forced to false when the controller is using an interactive Ul, or when 
-p (preview) is used. This enhances network reliability and performance. The default is 
true means the target agent automatically exits when appropriate. If set to false, the 
target agent will not exit until the controller ends the session. 

Applies to swconfig, swcopy, swinstall, swremove, swverify. 
age nt_time out_minutes=10000 

Causes a target agent to exit if it has been inactive for the specified time. This can be used 
to make target agents more quickly detect lost network connections since RPC can take as 
long as 130 minutes to detect a lost connection. The recommended value is the longest 
period of inactivity expected in your environment. For command line invocation, a value 
between 10 minutes and 60 minutes is suitable. A value of 60 minutes or more is recom¬ 
mended when the GUI will be used. The default of 10000 is slightly less than 7 days. 

Applies to swcopy, swinstall, swjob, swlist, swremove, swverify. 
allow_downdate=false 

Prevents the installation of an older revision of fileset that already exists at the targets. 
(Many software products do not support "downdating".) If set to true, the older revision 
can be installed. 

Applies to swinstall. 
allow_incompatible=false 

Requires that the software products which are being installed be "compatible!' with the tar¬ 
get selections. (All of the target selections must match the list of supported systems 
defined for each selected product.) If set to true, target compatibility is not enforced. 

Applies to swconfig, swinstall , and swverify. 
allow_multiple_versions=false 

Prevents the installation or configuration of another, independent version of a product 
when aversion already is already installed or configured atthetarget. 

If set to true, another version of an existing product can be installed into a new location, 
or can be configured in its new location. M ultipleversions can only be installed if a product 
is locatable. Multi pie configured versions will not work uni ess the product supports it. 

Applies to swconfig, swinstall , and swverify. 
alternate_source= 

Defines the alternate source which the agent will use when the 
use_alternate_source option issettotrue. The alternate source is specified using 
the syntax: 

[host][: ][path] 

If the host portion is not specified, then the local host is used. If the path portion is not 
specified, then the path sent by the command is used. The protocol sequence and endpoint 
given by the option swagent. rpc_binding_info are used when the agent attempts 
to contact an alternate source depot. 

Applies to swagent. 

ask=true (swask only) 

ask=false (swconfig and swinstall) 

Executes a request script, which asks for a user response. If ask=as_needed, 
swinstall executes the request script only if a response file does not already exist in the 
control directory. See swask(lM) for more information on request scripts. 

Applies to swask, swconfig, and swinstall. 
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auto_kernel_build=true 

Normally set to true. Specifies whether the removal of a kernel fileset should rebuild the 
kernel or not. If the kernel rebuild succeeds, the system automatically reboots. If set to 
false, the system continues to run thecurrent kernel. 

If the auto_kernel_build option is set to true, the autoreboot option must also 
be set to true. If the auto_kernel_build option is set to false, the value of the 
autoreboot option does not matter. 

Applies to swremove only, 
autoreboot=false 

Prevents the installation or removal of software requiring a reboot from the non-interactive 
interface. If set to true, then software can be installed or removed, after which thetarget 
system(s) will automatically reboot. 

An interactive session always asks for confirmation before software requiring a reboot is 
installed or removed. 

If the auto_kernel_build option is set to true, the autoreboot option must also 
be set to true. If the auto_kernel_build option is set to false, the value of the 
autoreboot option does not matter. 

Applies to swinstall and swremove. 
autorecover_product=false 

Causes swinstall to remove the original files as they are updated. If an error occurs 
during the installation (eg. network failure), then the original files are lost, and the instal¬ 
lation must be retried. 

If set to true, all files are saved as backup copies until all filesets in the current product 
loading are complete; then they are removed. At the cost of a temporary increase in disk 
space and slower performance, this allows for automatic recovery of the original filesets in 
that product if the load fails. 

Applies only to swinstall. 
autoremove_job=false 

Thisoption applies only to HP OpenView Software Distributor. 

Controls automatic job removal of completed jobs. If the job is automatically removed, job 
information (job status or target log files) cannot be queried with swjob. 

Install jobs to PCs can not be automatically removed. They should not be removed until 
thejob completes on all PC targets. 

autoselect_dependencies=true 

Controls the automatic selection of prerequisite and corequisite software that is not expli¬ 
citly selected by the user. When set to true, the requisite software is automatically 
selected for configuration. When set to false, requisite software which is not explicitly 
selected is not automatically selected for configuration. 

Applies to swconfig, swcopy, swinstall, and swverify. 
autoselect_dependents=false 

Controls the automatic selection of dependent software that is not explicitly selected by the 
user. A dependent is the opposite of a requisite. A dependent fileset has established either 
a prerequisite or a corequisite on the fileset under discussion. Specifying true causes 
dependent software to be automatically selected for the operation. The default, false 
causes dependent software, which is not explicitly selected, to not be automatically selected 
for the operation. 

Applies to swconfig and swremove. 


HP-UX Release 11.0: October 1997 


_9_ 


Section 5-289 


sd(5) 


(Hewlett-Packard Company) 


sd(5) 


autoselect_patches=true 

Automatically selects the latest patches (based on superseding and ancestor attributes) for 
a software object that a user selects for a swinstall or swcopy operation. When set to 
false, the patches corresponding to the selected object will not be automatically selected. 

The patch_filter option can be used in conjunction with autoselect_patches. 
Applies to swask, swinstall , and swcopy. 

aut o s elect_refe rence_bundle s=t rue 

If true, bundles that are sticky will be automatically installed, or copied, along with 
the software it is made up of. If false, the software can be installed, or copied, without 
automatically including sticky bundlesthat contain it. 

For swremove, if set to true, any bundle with the is sticky attribute set to true is 
removed automatically when the last of its contents is removed. If set to false, the 
sticky bundles will not be automatically removed. 

Applies to swcopy, swinstall, and swremove. 
check_contents=true 

Causes swverify to verify the time stamp, size, and checksum attributes of files. If set 
to false, these attributes are not verified. 

Applies to swverify. 
check permissions=true 

Causes swverify to verify the mode, owner, UID, group, andGID attributes of installed 
files. If set to false, these attributes are not verified. 

Applies to swverify. 
check_requisites=true 

Causes swverify to verify that the prerequisite and corequisite dependencies of the 
software selections are being met. If set to false, these checks are not performed. 

Applies to swverify. 
check_s cript s=t rue 

Causes swverify to run the fileset/product verify scripts for installed software. If set to 
false, these scripts are not executed. 

Applies to swverify. 
check_volatile=false 

Causes swverify to not verify those files marked as volatile (i.e. can be changed). If set 
to true, volatilefiles are also checked (for installed software). 

Applies to swverify. 
codewords 

Provides the "codeword" needed to unlock protected HP CD-ROM software. 

Some HP software products are shipped on CD-ROM as "protected" products. That is, they 
cannot be installed or copied unless a "codeword" and "customer ID" are provided. The 
codeword is found on the CD-ROM certificate which you received from HP. You may use 
this default specification on the command line or the SD-UX Interactive User Interface to 
enter the codeword. 

This default stores the codeword for future reference; it needs to be entered only once. If a 
new HP product is purchased and a previous codeword has already been entered for that 
CD-ROM, just enter the new codeword as usual and the codewords will be merged inter¬ 
nally. 

compress_cmd=/usr/contrib/bin/gzip 

Defines the command called to compress files before installing, copying or packaging. If the 
compression_type option is set to other than gzip or compress, this path must be 
changed. 

Applies to swpackage and swagent. 
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compress_files=false 

If set to true, files are compressed, if not already compressed, before transfer from a 
source. This will enhance performance on slower networks for swcopy and swinstall. 
and will result in smaller depots for swcopy and swpackage, unless the 
uncompress_f iles is also set to true. 

Applies to swcopy, swinstall, and swpackage. 
compression_type=gzip 

Defines the default compression type used by the agent when it compresses files during or 
after transmission. If uncompress_files is set to false, the compression_type is 
recorded for each file compressed so that the correct uncompression can later be applied 
during a swinstall, or a swcopy with uncompress_files set to true. The 
compress_cmd specified must produce files with the compression_type specified. 
The uncompress_cmd must be able to process files of the compression_type 
specified unless the format is gzip, which is uncompressed by the internal uncompressor 
(funzip). 

Applies to swagent. 

config_cleanup_cmd=/usr/lbin/sw/config_clean 

Defines the script called by the agent to perform release-specific configure cleanup steps. 

Appl i es to swagent. 
control_files= 

When adding or deleting control file objects, this option lists the tags of those control files. 
There is no supplied default. If there is more than one tag, they must be separated by whi¬ 
tespace and surrounded by quotes. 

A ppl i es to swmodi f y. 
controller_source= 

Specifies the location of a depot for the controller to access to resolve selections. Setting this 
option can reduce network traffic between the controller and the target. Use the target 
selection syntax to specify the location: 

[host][: ][path] 

This option has no effect on which sources the target uses and is ignored when used with an 
I nteracti ve U ser I nterface. 

Applies to swcopy, swconfig, swinstall, swremove, and swverify. 
create_t arget_acls=t rue 

If creating a target depot, swpackage will create Access Control Lists (ACLs) for the 
depot (if it is new) and all products being packaged into it. If set to false, and if the user 
is the superuser, swpackage will not create ACLs. (The swpackage command never 
creates ACLs when software is packaged on to a distribution tape.) 

A ppl i es to swpackage . 
create_target_path=true 

Causes the agent to create the target directory if it does not already exist. If set to false, 
a new target directory will not be created. This option can prevent the erroneous creation 
of new target depots. 

Applies to swcopy and swinstall. 
customer_id= 

This number, also printed on the Software Certificate, is used to "unlock" protected 
software and restrict its installation to a specific site or owner. It is entered using the -x 
customerJd= option or by using the Interactive User Interface. The customerjd can be 
used on any HP-UX 10.OX compatibleHP9000system. 
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defer_configure=false 

Causes swinstall to automatically configure the software_selections after they are 
installed. When an alternate root directory is specified, swinstall never performs the 
configuration task, since only hosts using the software should be configured. If set to 
true, this option allows configuration to be deferred even when the root directory is /. 

When installing a successive version of a product, it will not be configured if another ver¬ 
sion is already configured. The swconfig command must be run separately. 

Applies to swinstall. 

distribution_source_directory=/var/spool/sw 

Defines the default distribution directory to read as the source (when the source_type 
is directory). The -s option overrides this default. 

Applies to swcopy, swinstall , and swpackage . 

distribution_target_directory=/var/spool/sw 

Defines the default distribution directory of the target depot. The target_selection operand 
overrides this default. 

Applies to swacl, swcopy, swlist, swmodify, swpackage, swreg, swremove, 
and swverify. 

distribution_target_serial=/dev/rmt/Om 

Defines the default location of the target tape device file. The target_selection operand 
overrides this default. 

Appl i es to swpackage . 
enforce_dependencies=true 

Requires that all dependencies specified by the software_selections be resolved either in the 
specified source, or at the target_selections themselves. 

The swconfig, swcopy, and swinstall commands will not proceed unless the depen¬ 
dencies have also been selected or already exist at the target in the correct state 
(INSTALLED, CONFIGURED, or AVAILABLE). This prevents unusable software from 
being installed on the system. It also ensures that depots contain usablesets of software. 

For swremove, if a selected fileset has dependents (i.e. other software depends on the 
fileset) and they are not selected, do not remove the selected filesets. 

If set to false, dependencies will still be checked, but not enforced. Corequisite depen¬ 
dencies, if not enforced, may keep the selected software from working properly. Prere- 
quisitedependencies, if not enforced, may cause the installation or configuration to fail. 

Applies to swconfig, swcopy, swinstall, swremove, and swverify. 
enforce_dsa=true 

Prevents a command from proceeding past the analysis phase if the disk space required is 
beyond the available free space of the impacted file systems. If set to false, then the 
install, copy, or package operation will use the file systems' minfree space and may fail 
because it reaches the file system's absolute limit. 

Applies to swcopy, swinstall, and swpackage. 
enforce_kernbld_failure=true 

Prevents swinstall from proceeding past the kernel build phase if the kernel build 
processes fail. If set to false, then theinstall operation will continue (without suspension 
if in the interactive mode) despite failure or warnings from either the system preparation 
process or the kernel build process. 

Applies to swinstall. 
enforce_scripts=true 

If a fileset/product checkinstall or checkremove script fails (i.e. returns with exit code 1), 
none of the filesets in that product will be installed or removed. If set to false, the install 
or remove operation will proceed even when a check script fails. 

Applies to swinstall and swremove. 
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files= When adding or deleting file objects, this option lists the pathnames of those file objects. 

There is no supplied default. If there is more than one pathname, they must be separated 
by whitespace. 

A ppl i es to swmodi f y. 
follow_symlinks=false 

Do not follow symbolic links in the package source files, but include the symbolic links in 
the packaged products. A value of true for this keyword causes swpackage to follow 
symbolic links in the package source files and include the files they reference in the pack¬ 
aged products. 

Applies to swpackage. 
force_job_removal=false 

Thisoption applies only to HP OpenView Software Distributor. 

By default, the job information is removed from the central controller only after removing 
the job information stored on each of the targets succeeds. If the job should be removed 
regardless of the success of the removal of job information from targets, set this option to 

true. 

Applies to swjob. 
force_single_target=false 

This option applies to HP-UX 10* only. 

This option applies only to the I nteractive User I nterface when no SD-OV license is in effect 
on a system that is a diskless server. It causes swremove to run in a singletarget mode, 
even though a diskless server normally causes swremove to run in multi-target mode. 

include__file_revisions=false 

Do not include each source file's revision attribute in the products being packaged. Because 
this operation is time consuming, by default the revision attributes are not included. If set 
to true, swpackage will execute what(l) and possibly ident(l) (in that order) to try to 
determine a file's revision attribute. 

Appl i es to swpackage . 

install_cleanup_cmd=/usr/lbin/sw/install_clean 

Defines the script called by the agent to perform release-specific install cleanup steps 
immediately after the last postinstall script has been run. For an OS update, this script 
should at least remove commands that were saved by the install_setup script. This 
script is executed after all filesets have been installed, just before the reboot to the new 
operati ng system. 

A ppl i es to swagent. 

install_setup_cmd=/usr/lbin/sw/install_setup 

Defines the script called by the agent to perform release-specific install preparation. For an 
OS update, this script should at least copy commands needed for the checkinstall, prein¬ 
stall, and postinstall scripts to a path where they can be accessed while the real commands 
are being updated. This script is executed before any kernel filesets are loaded. 

Appl i es to swagent. 
job polling interval=30 

Thisoption applies only to HP OpenView Software Distributor. 

Defines the polling interval, in minutes, used by the daemon. It specifies how often a PC 
install job will be polled in order to cache the progress of remote targets on the controller. 

Applies to swinstall. 
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job_title= 

Thisoption applies only to HP OpenView Software Distributor. 

This is an ASCII string giving a title to a job. It is displayed along with the job ID to pro¬ 
vide additional identifying information about a job when swjob is invoked. 

Applies to swconfig, swcopy, swinstall, swremove, and swverify. 

kernel_build_cmd=/usr/sbin/mk_kernel 

Defines the script called by the agent for kernel building. 

Applies to swagent. 
kernel path=/stand/vmunix 

Defines the path to the system's bootable kernel. This path is passed to the 
kernel_build_cmd via the SW_KERNEL_PATH environment variable. 

Appl i es to swagent. 
layout_version=l.0 

Specifies the POSIX layout_version to which the SD commands conform when writ¬ 
ing distributions and swlist output. Supported values are "1.0" (default) and "0.8". SD for 
HP-UX version 10.10 and later can read or write either layout version. 

SD object and attribute syntax conforms to the I ayout_versi on 1.0 specification of the IEEE 
POSIX 1387.2 Software Administration standard. SD commands still accept the keyword 
names associated with the older layout version, but you should use 
layout_version=0 .8 only to create distributions readable by older versions of SD. 

The version used by swpackage can be controlled by specifying the Iayout version attri¬ 
bute in the product specification file (PSF). However, if the Iayout_version attribute in the 
PSF is 1.0, the isjocatable attribute defaults to true in all cases, and must be explicitly set 
to false. (See swpackage(4) for more information on PSFs.) 

Layout version 1.0 adds significant functionality not recognized by systems supporting only 
0.8, including: 

• Category class objects (formerly the category and category_title attributes 
within the bundle or product class). 

• Patch-handling attributes, including applied_patches, is_patch, and 

patch_state. 

• Thefileset architecture attribute, which permits you to specify the architecture 
of the target system on which the product will run. 

In addition to adding new attributes and objects, layout_version 1.0 changes the following 
preexisting 0.8 objects and attributes as follows: 

• Replaces the depot media_sequence_number with the media object with a 
sequence_number attribute. 

• Replaces the vendor definition within products and bundles with a vendor_tag 
attributeand a corresponding vendor object defined outside the product or bundle. 

• Pluralizes the corequisite and prerequisite fileset attributes (to core¬ 
quisites and prerequisites). 

• Changes the timestamp attribute to mod_time. 

Applies to swpackage, swcopy, swmodify, and swlist. 
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level= 


Specifies a software I a/el for swlist, swacl, or swreg. 
For swlist: 


Lists all objects down to the specified lev/el. Both the specified level (s) and the depth of the 

specified software_selections control the depth of the swlist output. The supported 

software levels are: 

bundle Show all objects down to the bundle level. 

product Show all objects down to the product level. Also use -I bundle-l product to 

show bundles. 

subproduct Show all objects down to the subproduct level. 

fileset Show all objects down to thefileset level. Also use -I fileset -I subproduct to 
show subproducts. 

file Show all objects down to the file level (i.e. depots, products, filesets, and 

files). 

category Show all categories of availablesoftwareobjects. 

patch Show all applied patches. 


The supported depot and root levels are: 

depot Show only the depot level (i.e. depots which exist at the specified target 

hosts). 

root List all alternate roots. 

shroot List all registered shared roots (FIP-UX 10.X only), 

prroot List all registered private roots (FIP-UX 10.X only). 


The machine, user, and group levels apply only to HP OpenView Software Distributor PC 
target files. 


machine Show the machines known to a PC controller, 
user Show the users known to a PC controller, 

group Show the groups known to a PC controller. 


For swacl: 


The level option defines the level of ACLs to view or modify: 

host View/modify the ACL protecting the host system(s) identified by the 

target_selections. 

depot View/modify the ACL protecting the software depot(s) identified by the 

target_selections. 

root View/modify the ACL protecting the root file system(s) identified by the 

target_selections. 

product View/modify the ACL protecting the software product identified by the 
software_selection. Applies only to products in depots, not installed pro¬ 
ducts in roots. 

product_template 

View/modify the template ACL used to initialize the ACL(s) of future 
product(s) added to the software depot(s) identified by the target_selections. 

global_soc_template 

View/modify the template ACL used to initialize the ACL(s) of future 
software depot(s) or root file system(s) added to the host(s) identified by the 
target_selections. 

global_product_template 

View/modify the template ACL used to initialize the 
product_template ACL(s) of future software depot(s) added to the 
host(s) identified by thetarget selections. 
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For swreg: 

The level option defines the level of object to register or unregister: 
depot Depots which exist at the specified target hosts, 

root All alternate roots. 

shroot All registered shared roots (FIP-UX 10.X only), 
prroot All registered private roots (HP-UX 10.X only). 

Applies to swacl, swlist, and swreg. 
log_msgid=0 

Controls whether numeric identification numbers are prepended to logfile messages pro¬ 
duced by SD: 

0 (default) No identifiers are attached to messages. 

1 Appliesto ERROR messages only. 

2 Appliesto ERROR and WARN I NG messages. 

3 Appliesto ERROR, WARNI NG, and NOTE messages. 

4 Appliesto ERROR, WARNI NG, NOTE, and certain other logfile messages. 

Appliesto swconfig, swcopy, swinstall, swreg, swremove, and swverify. 
logdetail=false 

The logdetail option controls the amount of detail written to the log file. When set to 
true, this option adds detailed task information (such as options specified, progress state¬ 
ments, and additional summary information) to the log file. This information is in addition 
to log information controlled by the loglevel option. 

Here are the possible combi nations of loglevel and logdetail options: 


Log Level 

Log Detail 

Information Included 

loglevel=0 


No information is written to the 
logfile. 

loglevel=l 

logdetail=false 

Only key events are logged; this is the 
default. 

loglevel=l 

logdetail=true 

Event detail as above plus task pro¬ 
gress messages. Setting loglevel =1 is 
not necessary, it is the default. 

loglevel=2 

logdetail=false 

Event and file level messages only. 
Setting the logdetail=false option is 
not necessary. 

loglevel=2 

logdetail=true 

All information is logged. Setting both 
loglevel=2 and logdetail=true options 
is required. Thiscombination may pro¬ 
duce the same logfile behavior as pre¬ 
vious HP-UX 10.x releases. 


Appliesto swconfig, swcopy, swinstall, swreg, swremove, and swverify. 

logfile=/var/adm/sw/sw<command>.log 

Defines the default log file for each SD command. (The agent log files are always located 
relative to the target depot or target root, eg. /var/spool/sw/swagent. log and 
/var/adm/sw/swagent. log.) 

Appliesto all commands except swacl, swlist, and swjob (HP OpenView Software 
Distributor). 
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loglevel=l 

Controls the log level for the events logged to the command logfile, the target agent logfile, 
and the source agent logfile by prepending identification numbers to SD logfile messages. 
This information is in addition to the detail controlled by the logdetail option. See 
logdetail for more information. 

A value of 

0 provides no information to the log files. 

1 enables verbose logging to the log files. 

2 enables very verbose logging to the log files. 

Applies to swconfig, swcopy, swinstall, swmodify, swpackage, swremove, 
and swverify. 

mat ch_t arget = false 

If set to true, software selection is done by locating filesets on the source that match the 
target system's installed filesets. If multiple targets are specified, the first in the list is 
used as thebasisfor selections. 

Applies to swinstall. 
max_agents=-l 

The maximum number of agents that are permitted to run simultaneously. The value of -1 
means that there is no limit. 

Applies to swagentd. 
media_capacity=1330 

If creating a distribution tape, this keyword specifies the capacity of the tape in Mbytes. 
This option is required if the media is not a DDS tape or a disk file. Without this option, 
swpackage sets the size to 1330 M bytes for tape and "free space up to minfree! , on a disk 
file. 

Appl i es to swpackage . 
media_type=directory 

Defines the type of distribution to create. The recognized types are directory and 
tape. 

Appl i es to swpackage . 
minimum job polling interval=l 

Thisoption applies only to HP OpenView Software Distributor. 

Defines how often, in minutes, the daemon will wake up and scan the job queue to deter¬ 
mine if any scheduled jobs need to be initiated or if any PC install jobs need their remote 
target status cached locally (see job_polling_interval ). If set to 0, no scheduled 
jobs will be initiated, and no caching of PC install jobs will occur. 

Applies to swagentd. 
mount_all_filesystems=true 

By default, the SD commands attempt to mount all filesystems in the /etc/f stab file at 
the beginning of the analysis phase, to ensure that all listed filesystems are mounted before 
proceeding. This policy helps to ensure that files are not loaded into a directory that may 
be below a future mount point, and that the expected files are availablefor a remove or ver¬ 
ify operation. 

If set to false, the mount operation is not attempted, and no check of the current mounts 
is performed. 

Applies to swconfig, swcopy, swinstall, swremove, and swverify. 
mount_cmd=/sbin/mount 

Defines the command called by the agent to mount all filesystems. 

Appl i es to swagent. 
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objects_to_register= 

Defines the default objects to register or unregister. There is no supplied default (see 
select_local above). If there is more than one object, they must be separated by 
spaces. 

Applies to swreg. 
one_liner= 

Defines the attributes which are listed in the non-verbose listing. 

Applies to swlist and HP OpenView Software Distributor's swjob. 

os_name 

This option can be used in conjunction with os_release to specify fileset selection for an 
HP-UX update. os_name should only be specified from the command line. Refer to the 
SD readme filefor correct syntax. You can displaythe readme file by entering: 

swlist -d -a readme SW-DIST [@ host:/depot ] 

Applies to swinstall. 
os_release 

This option can be used in conjunction with os_name to specify fileset selection for an 
HP-UX update. os_release should only be specified from the command line. Refer to 
theSD readme filefor correct syntax. You can displaythe readme file by entering: 

swlist -d -a readme SW-DIST [@ host:/depot ] 

Applies to swinstall. 
package_in_place=false 

If set to true, swpackage will package the specified products such that the target depot 
will not contain the files that make up a product. I nstead, swpackage inserts references 
to the original source files used to build a product. This behavior allows products to be 
packaged without consuming the full disk space of copying all the source files into the tar¬ 
get depot. 

Applies to swpackage . 
pat ch_commit = false 

Commits a patch by removing files saved for patch rollback. When set to true, and run 
with swmodify, you cannot roll back (remove) a patch unless you remove the associated 
base software that the patch modified. 

A ppl i es to swmodi f y. 
patch_filter=*.* 

Specifies a software_specification for a patch filter. The default value is * . *. 

This option can be used in conjunction with the autoselect_patches and 
patch_match_target options to filter the selected patches to meet the criteria 
specified by software_specification. 

Applies to swask, swcopy, and swinstall, 
patch_match_target=false 

If set to true, this option selects the latest patches (software identified by the is_patch 
attribute) that correspond to software on the target root or depot. 

The patch_filter= option can be used in conjunction with patch_match_target. 
Applies to swcopy and swinstall. 

patch_one_liner=title patch_state 

Specifies the attributes displayed for each object listed when the -1 patch option is 
invoked and when no -a or -v option is specified. The default display attributes are 
title and patch_state. 

Applies to swlist and swjob. 
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pat ch_s ave_file s=t rue 

Saves patched files, which permits future rollback of patches. When set to false, patches 
cannot be rolled back (removed) unless the base software modified by the patch is removed 
at the same time. 

Applies to swinstall. 
poll_now=false 

Thisoption applies only to HP OpenView Software Distributor. 

The status information displayed for a PC install job is as recent as the last time the dae¬ 
mon polled remote targets for information (see the option job_polling_interval). 
If the most recent status is wanted set this option to true. 

Applies to swjob. 
polling_interval=2 

Defines in seconds the polling interval used by interactive (GUI) sessions. It specifies how 
often each target agent will be polled to obtain status information about thetask being per¬ 
formed. When operating across wide-area networks, the polling interval can be increased 
to reduce network overhead. 

Applies to swcopy, swinstall, and swremove. 

reboot_cmd=/sbin/reboot 

Defines the command called by the agent to reboot the system. 

Applies to swagent. 
reconfigure=false 

Prevents software which is already in the CONFIGU RED state from being reconfigured. If 
set to true, CONFIGURED software can be reconfigured. 

Applies to swconfig. 
register_new_depot=t rue 

Causes swcopy to register a newly created depot with the local swagentd. This action 
allows other SD commands to automatically "see! 1 this depot. If set to false, a new depot 
will not be automatically registered. (It can be registered later with the swreg com¬ 
mand.) 

Appl i es to swcopy. 
register_new_root=true 

Causes swinstall to register a newly created alternate root with the local swagentd. 
This action allows other SD commands to automatically "see! 1 this root. If set to false, a 
new root will not be automatically registered. (It can be registered later with the swreg 
command.) 

Applies to swinstall. 
reinstall=false 

When re-installing (or re-copying) an existing version of a fileset, this option causes that 
fileset to be skipped, i.e. not re-installed. If set to true, the fileset will be re-installed (re¬ 
copied). 

Applies to swinstall and swcopy. 
reinstall_files=true 

Causes all the files in a fileset to always be re-installed, re-copied, or re-packaged, even 
when the file already exists at the target and is identical to the new file. If set to false, 
files that have the same checksum (see next option), size and time stamp will not be re¬ 
installed, re-copied, or re-packaged. This check enhances performance on slow networks or 
slow disks. 

Applies to swinstall, swcopy, and swpackage . 
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reinstall_files_use_cksum=true 

This option affects the operation when the reinstall_files option is set to false. It 
causes the checksums of the new and old fileto be computed and compared to determine if 
the new file should replace the old one. (The checksum is slower, but is a more robust way 
to check for files being equivalent.) If set to false, the checksums are not computed, and 
files are (not) reinstalled based only on their size and time stamp. For swpackage, the 
default valuefor this option is false. 

Applies to swcopy, swinstall, and swpackage. 
remove_empty_depot=t rue 

Remove an empty depot when the last product is removed. If set to false, an empty 
depot will not be removed, preserving any depot ACLs. 

A ppl i es to swremove. 
remove_f anout_depot =t rue 

Thisoption applies only to H P OpenView Software Distributor. 

When an install job to a PC is removed the software associated with that job is automati¬ 
cally removed from the PC depot. If the software that is part of this job is the same 
software being used by another job, then be sure to not delete the software as part of the 
job removal. If the software on the PC depot should be retained, set this option to false. 

Applies to swjob. 

remove_obsolete_filesets=false 

Controls whether swcopy automatically removes obsoletefiIesets from target products in 
the target depot. If set to true, swcopy removes obsolete filesets from the target pro¬ 
ducts that were written to during the copy process. Removal occurs after the copy is com¬ 
plete. Filesets are defined as obsolete if they were not part of the most recent packaging of 
the product residing on the source depot. 

A ppl i es to swcopy. 

remove_setup_cmd=/usr/lbin/sw/remove_setup 

Defines the script called by the agent to perform release-specific removal preparation. For 
an OS update, this script invokes the tlink command when a fileset is removed. 

Applies to swagentd. 
retry_rpc=l 

Defines the number of times a lost source connection will be retried during file transfers. A 
lost connection is one that has timed out. When used in conjunction with the 
rpc_timeout option, the success of installing over slow or busy networks can be 
increased. If set to zero, then any rpc_timeout to the source will cause the task to 
abort. If set from 1 to 9, then the install of each fileset will be attempted that number of 
times. The reinstall_files option should also be set to false to avoid installing files within 
the fileset that were successfully installed. 

Applies to swcopy and swinstall. 
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rpc_binding_info=ncacn_ip_tcp:[2121] ncadg_ip_udp:[2121] 

Defines the protocol sequence(s) and endpoint(s) on which the daemon listens and on which 
the other commands use to contact the daemon. If the connection fails for one protocol 
sequence, the next is attempted. SD supports both the tcp (ncacn_ip_tcp:[2121]> and udp 
(ncadg_ip_udp:[2121]) protocol sequence on most platforms. 

Thevalue(or values for swagentd) can havefollowingform: 

• A DCE string binding containing a protocol sequence and an endpoint. The syntax is: 
protocol_sequence:[endpoint], 

• The name of a DCE protocol sequence with no endpoint specified. The syntax is: 
protocol_sequence, for example ncadg_ip_udp or ncacn_ip_tcp. (A 
trailing : can be attached to the protocol sequence, it has no effect.) Since no end¬ 
point is specified, the DCE endpoint mapper rpcd must be running and will be used to 
find the endpoint registered by the swagentd. 

• The literal string all. This entry means to use (try) all protocol sequences supported 
by the DCE RPC. It should be the only entry in the list. The DCE endpoint mapper 
rpcd also must be running in order to use this option. 

Applies to all commands except swask, swpackage, and swmodify. 

rpc_binding_info_alt_source=ncadg_ip_udp:[2121] 

Defines the protocol sequence(s) and endpoint(s) used when the agent attempts to contact 
an alternate source depot specified by the alternate_sourceoption . HP-UX supports 
both the udp(ncadg_ip_udp : [2121] ) and tcp(ncacn_ip_tcp: [2121] ) protocol 
sequence/endpoint. SD on SunOS only supports udp (ncadg_ip_udp : [2121]). By 
default udp is used. 

Applies to swagentd. 
rpc_timeout=5 

Relative length of the communications timeout. This is a value in the range from 0 to 9 and 
is interpreted by the DCE RPC. Higher values mean longer times; you may need a higher 
valuefor a slow or busy network. Lower values will give faster recognition on attempts to 
contact hosts that are not up, or are not running swagentd. Each value is approximately 
twice as long as the preceding value. A value of 5 is about 30 seconds for the 
ncadg_ip_udp protocol sequence. Thisoption may not haveany noticeable impact when 
using the ncacn_ip_tcp protocol sequence. 

Applies to all commands except swpackage and swmodify. 
select_local=true 

If no target selections are specified, select the default target_directory of the local 
host as the target_selection for the command. 

Applies to swacl, swconfig, swcopy, swinstall, swlist, swreg, swremove, 
and swverify. 

software^ 

Defines the default software_selections. There is no supplied default. If there is more than 
one software selection, they must be separated by spaces. Software is usually specified in a 
software input file, as operands on the command line, or in theGU I. 

Applies to all commands except swreg and HP OpenView Software Distributor's swjob. 
software_view=products 

I ndicates the software view to be used by the interactive interface of the commands and by 
swlist for the default listing level. It can be set to products, all_bundles, or a bundle 
category tag (to indicate to show only bundles of that category). 

Applies to swcopy, swinstall, swlist, and swremove. 
source_cdrom=/SD_CDROM 

Defines the default location of the source CD-ROM. This syntax can behost:path. 
Applies to swinstall. 
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source_depot_audit=t rue 

If both source and target machine are updated to HP-UX version 10.30 or later, the system 
administrator at the source depot machine can set this option to track which user pulls 
which software from a depot on the source machine and when the software is pulled. (Note 
that a user running swinstall/swcopy from a target machine cannot set this option; 
only the administrator of the source depot machinecan set it.) 

When source_depot_audit is set to true, a swaudit. log file is created on the 
source depot (for writable directory depots) or in /var/tmp (for tar images, CD-ROMs, or 
other non-writabledepots). 

Users can invoke the swlist interactive user interface (using swlist -i -d)toview, 
print, or save the audit information on a remote or local depot. Users can view audit infor¬ 
mation based on language preference, as long as the system has the corresponding SD mes¬ 
sage catalog files on it. For example, a user can view the source audit information in 
J apanese during one invocation of swlist, then view the same information in English at 
the next invocation. 

Applies to swagent, swinstall , and swlist. 
source_file=psf 

Defines the default location of the source product specification file (PSF). The host :path 
syntax is not allowed, only a valid path can be specified. The -s option overrides this 
value. 

Applies to swpackage and swmodify. 
source_tape=/dev/rmt/Om 

Defines the default location of the source tape, usually the character-special file of a local 
tape device. If the host :path syntax is used, the host must match the local host. The 
-s option overrides this value. 

Applies to swcopy and swinstall. 
source_type=directory 

Defines the default source type: cdrom, file, directory, or tape. The source type 
derived from the -s option overrides this value. 

Applies to swcopy, swinstall, and swpackage. (The values cdrom, and tape 
apply to swcopy and swinstall only. Thevaluefile applies to swpackage only.) 

system__f ile_path=/stand/system 

Defines the path to the kernel's template file. This path is passed to the 
system__prep_cmd via the SWSYSTEM FILE PATH environment variable. 

Applies to swagent. 

system_prep_cmd=/usr/lbin/sysadm/system_prep 

Defines the kernel build preparation script called by the agent. This script must do any 
necessary preparation so that control scripts can correctly configure the kernel about to be 
built. This script is called before any kernel filesets have been loaded. 

Appl i es to swagent. 
targets= 

Defines the default target selections. There is no supplied default (see select_local 
above). If there is more than one target selection, they must be separated by spaces. Tar¬ 
gets are usually specified in a target input file, as operands on the command line, or in the 
GUI. 

Applies to all commands. 
uncompress_cmd= 

Defines the command to uncompress files when installing, copying, or packaging. This 
command processes files which were stored on the media in a compressed format. If the 
compression_type of the file is gzip then the internal uncompression (funzip) is 
used instead of the external uncompress_cmd. 

Applies to swpackage and swagent. 
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uncompress_files=false 

If the files being transferred from a source are compressed, setting this option will 
uncompress the files before storing them on the target depot. 

Applies to swcopy and swpackage . 
use_alternate_source=false 

Empowers each target agent to use its own, configured alternate source, instead of the one 
specified by the user. If false, each target agent will use the same source, namely the 
source specified by the user and validated by the command. If true, each target agent 
will instead use its own configured valuefor thesource. 

Applies to swcopy and swinstall. 
verbose= 

Controls the verbosity of a non-interactive command's output: 

0 disables output to stdout. (Error and warning messages are always written to stderr). 

1 enables verbose messaging to stdout. 

2 for swpackage and swmodify, enables very verbose messaging to stdout. 

For the swlist command, a verbose listing includes all attributes that have been defined 
for the appropriate level of each software_selection operand. The attributes are listed, one 
per line, prefaced by the attribute keyword. 

The -v option overrides this default if it is set to 0. 

Applies to all commands. 

write_remote_files=false 

Prevents the installation, copying, or packaging of files to a target which exists on a remote 
(NFS) file system. Also prevents the removal of files from a remote file system. All files 
destined for (or already on) a remote filesystem will be skipped. 

If set to true and if the superuser has write permission on the remote file system, the 
remote files will not be skipped, but will be installed, copied, packaged, or removed. 

Applies to swcopy, swinstall, swpackage, and swremove. 


Session Files 

Each invocation of an SD command defines a task session. Most SD commands automatically save options, 
source information, software selections, and target selections before the task actually commences. This lets 
you re-execute the command even if the session ends before the task is complete. You can also save session 
information from interactive or command-linesessions. 

Session information is saved to the file $HOME/ . sw/sessions/ command name. last . This file is 
overwritten by each invocation of thecommand. The file uses the same syntax as thedefaults files. 

From an interactive session, you can save session information into a file at any time by selecting the Save 
Session or SaveSession As option from the Filemenu. 

From a command-line session, you can savesession information by executing the command with the 

-C session_file option. You can specify an absolute path for a session file. If you do not specify a directory, 

the default location is $HOME/ . sw/sessions/. 

To re-execute a saved session from an interactive session, use the Recall Session option from the Filemenu. 
To re-execute a session from a command-line, specify the session file as the argument for the -S option. 

When you re-execute a session file, the values in the session file take precedence over values in the system 
defaults file. Likewise, any command-line options and parameters take precedence over the values in the 
session file. 
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Software and Target Lists 

Most SD commands support software and target selections from separate input files (see the -f and -t 
options). Software and targets specified in these files will be selected for operation. 

Additionally, commands that support an interactive interface read a list of possible hosts to operate on from 
the values found in: 

/var/adm/sw/def aults . hosts the system-wide default list of hosts, 

$HOME/ . sw/defaults .hosts the user-specific default list of hosts. 

Hosts in this file are not marked for operation, but provide a default list from which to choose. For each 
interactive command, target hosts containing roots, containing depots, and hosts serving as fanout servers 
are specified in separate lists ( hosts, hosts_with_depots, and fanout_servers respectively). 
The list of hosts are enclosed in {}braces and separated by whitespace (blank, tab and newline). For exam¬ 
ple: 

swinstall.hosts={hostA hostB hostC hostD 
hostE hostF} 

swinstall. fanout_servers= {pci pc2} (HP OpenView Software Distributor only) 
swcopy.hosts_with_depots={hosts} 

swcopy. fanout_servers={pcl pc2} (HP OpenView Software Distributor only) 
swremove.hosts={hostA hostB hostC hostD 
hostE hostF) 

swremove.hosts_with_depots={hosts} 

Most SD commands support patch filtering with the -x patch_filter=software_specification option. 
In addition, the interactive user interface commands, swinstall and swcopy read a list of possible 
patch filters. The user can use the values from this list for selection criteria. The lists are stored in: 

/var/adm/sw/defaults.patchfilters 

the system-wide default list of patch filters. 

$HOME/.sw/defaults.patchfilters 

the user-specific default list of patch filters. 

Filters in this file are not marked for selection use but provide a default list from which the user can 
choose. The list of patch filters is enclosed in braces {}and separated by white space (blank, tab, or new- 
line). For example: 

swinstall.patch_filter_choices={ 

*.*,c=enhancement 
*.*,c=critical 
} 

swremove.patch_filter_choices={ 

Product.Fileset,c=halts_system 

} 

Thefollowing PC information applies to HP OpenView Software Distributor only. 

For installing to PCs, PC target lists are generated automatically by querying the PC file server associated 
with a PC controller. Any user, group, or machine known to the file server will be included in the default 
list from which to choose. Additionally, all machines known to the file server will by default be selected for 
installation when selecting a PC controller. 
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Environment Variables 

SD programs are affected by external environment variables, set environment variables for use by the con¬ 
trol scripts, and set additional environment variables that affect scripts run by swinstall and 
swremove. 

External environment variables that affect theSD commands: 

LANG Determines the language in which messages are displayed. If LANG is not specified or is 
set to the empty string, a default valueof C is used. See lang(5) for more information. 

NOTE: The language in which theSD agent and daemon log messages are displayed is set 
by the system configuration variable script, /etc/rc.config.d/LANG. For example, 
/etc/rc. conf ig. d/LANG, must be set to LANG= ja_JP . SJIS or 
LANG= ja_JP .eucJP to make the agent and daemon log messages display in J apanese. 

This variableappliesto all SD commands except swgettools. 

Environment variables that affect scripts: 

SW_CONTROL_DIRECTORY 

Defines the current directory of the script being executed, either a temporary catalog directory, 
or a directory within in the Installed Products Database (I PD). This variabletells scripts where 
other control scripts for the software are located (eg. subscripts). 

SWLOCATION 

Defines the location of the product, which may have been changed from the default product 
directory. When combined with the SW_ROOT_DlRECTORY, this variabletells scripts where 
the product files are located. 

SWPATH 

A PATFI variable which defines a minimum set of commands available to for use in a control 
script (e.g. /sbin: /usr/bin). 

SWROOT DIRECTORY 

Defines the root directory in which the session is operating, either"/" or an alternate root direc¬ 
tory. This variabletells control scripts the root directory in which the products are installed. A 
script must use this directory as a prefix to SWLOCATION to locate the product's installed files. 
The configure script is only run when SW_ROOT_DI RECTORY is "/". 

SW_SESSION_OPTIONS 

Contains the pathname of a file containing the value of every option for a particular command, 
including software and target selections. This lets scripts retrieve any command options and 
values other than the ones provided explicitly by other environment variables. For example, 
when the file pointed to by SW_SESSlONS_OPTlONS is made availableto a request script, the 
targets option contains a list of software_collection_specs for all targets specified for the com¬ 
mand. When the file pointed to by SW_SESSlONS_OPTlONS is made availableto other 
scripts, the targets option contains the single software_collection_spec for the targets on which 
the script is being executed. 

SWSOFTWARE SPEC 

This variable contains the fully qualified software specification of the current product or fileset. 
The software specification allows the product or fileset to be uniquely identified. 

Additional environment variables that affect scripts run by swinstall and swremove: 
SW_DEFERRED_KERNBLD 

Only applies to swinstall . This variable is normally unset. If it is set, the actions necessary 
for preparing the system file /stand/system cannot be accomplished from within the postin¬ 
stall scripts, but instead must be accomplished by the configurescripts. This occurs whenever 
software is installed to a directory other than /, such as for a cluster client system. This vari¬ 
able should be read only by the configure and postinstall scripts of a kernel fileset. The swin¬ 
stall command sets these environment variables for use by the kernel preparation and build 
scripts. 

SWINITIALINSTALL 

Only applies to swinstall . This variableis normally unset. If it isset, the swinstall ses¬ 
sion is being run as the back end of an initial system software installation ("cold" install). 

SW_KERNEL_PATH 

Only applies to swinstall . The path to the kernel. The default value is /stand/vmunix, 
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defined by the swagent option or kernel__path . 

SWSESSIONISKERNEL 

Indicates whether a kernel build is scheduled for the current install/remove session. A TRUE 
value indicates that the selected kernel fileset is scheduled for a kernel build and that changes to 
/stand/system are required. A null value indicates that a kernel build is not scheduled and 
that changes to /stand/system are not required. 

The value of this variable is always equal to the value of SW_SESSlON_lS_REBOOT. 
SW_SESSION_IS_REBOOT 

Indicates whether a reboot is scheduled for a fileset selected for removal. Because all HP-UX 
kernel filesets are also reboot filesets, the values of this variables is always equal to the value of 

SW_S E S SION IS KERNEL. 

SW_SYSTEM_FILE_PATH 

Only applies to swinstall. The path to the kernel's system file. The default value is 
/stand/system. 


Signals 

The SD commands catch the signals SIGQUIT and SIGINT. If these signals are received, the command 
prints a message, sends a Remote Procedure Call (RPC) to the agents to wrap up, and then exits. 

The agent ignores SIGHUP, SIGINT, and SIGQUIT. It immediately exits gracefully after receiving 
SIGTERM, SIGUSR1, or SIGUSR2. Killing the agent may leave corrupt software on the system, and thus 
should only be done if absolutely necessary. Note that when an SD command is killed, the agent does not 
terminate until completing the task in progress. 

The daemon ignores SIGHUP, SIGINT and SIGQUIT. It immediately exits gracefully after receiving 
SIGTERM and SIGUSR2. After receiving SIGUSR1, it waits for completion of a copy or remove from a 
depot session before exiting, so that it can register or unregister depots if necessary. Requests to start new 
sessions are refused during this wait. 

Locking 

SD commands use a common locking mechanism for reading and modifying both root directories and 
software depots. This mechanism allows multiple readers but only one writer on a root or depot. 

The SD commands which modify software in an (alternate) root directory are restricted from simultaneous 
modification usingfcntl(2) locking on thefile 

var/adm/sw/product s/swlock 
relative to the root directory (e.g. /var/adm/sw/products/swlock). 

The SD commands which modify software in a depot are restricted from simultaneous modification using 
fcntl(2) locking on thefile 

catalog/swlock 

relative to the depot directory (e.g. /var/spool/sw/catalog/swlock). 

All commands set fcntl(2) read locks on roots and depots using the swlock file mentioned above. When a 
read lock is set, it prevents other SD commands from performing modifications (i.e. from setting write 
locks). 

RETURN VALUES 

Each SD command invocation returns: 

0 The sw<task>successfully completed. 

1 The sw<task>failed on all target_selections. 

2 The sw<task>failed on some target_selections. 
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DIAGNOSTICS 

The swconfig, swcopy, swinstall, swmodify, swpackage, swremove, and swverify com¬ 
mands support a preview mode, where operation will proceed through the analysis of each target_selection, 
then exit before the actual task is performed. 

The HP OpenView Software Distributor interactive interface (invoked using the sd command) and the 
swjob command can be used to view the current status of any job as well as the controller and target log 
files. 

Preview is only applicable for non-interactive operation, since the interactive commands wait for 
confirmation after analysis. I n the interactive mode, you can resolve invalid conditions that the commands 
discover before they actually begin loading or removing files. 

Standard Output 

When non-interactive, the commands write messages for significant events. These events include: 

• a begin and end task message, 

• a message for starting the task on each host, and 

• a message for completing the task on each host. 

When the verbose option is set, summary messages about the task are also sent to the standard output. 

Standard Error 

When non-interactive, thecommands also write messages for thefollowing significant error events: 

• a message for each host failing analysisand 

• a message for each host failing the actual task. 


Logging 

All commands log major events on the host where the command was invoked. They log detailed events to 
the swagent log associated with each target_selection. 

Command Log 

The commands log messages to /var/adm/sw/sw<task>.log. (The user can specify a different 
logfile by modifying the logfile option.) 

Target Log 

A swagent process performs the actual swacl, swconfig, swcopy, swinstall, swremove, 
and swverify operation at each target selection. For operations on target root objects, the 
swagent logs messages to the file var/adm/sw/swagent. log beneath the root directory (e.g. 
/ or an alternate root directory). For operations on target depot objects, the swagent logs mes¬ 
sages to the file swagent.log beneath the depot directory (e.g. /var/spool/sw). 

The swagentd running on a host logs events to the file /var/adm/sw/swagentd. log. 

Source Depot Audit Log 

If both source and target machine are updated to HP-UX version 10.30 or later, the system adminis¬ 
trator at the source depot machine can track which user pulls which software from a depot on the 
source machine and when the software is pulled. Refer to the source_depot_audit option in 
swagent(lM) for more information. 

Thefollowing PC information applies to HP OpenView Software Distributor only. 

On a PC controller, SWAGENTD. EXE logs events and messages to the file 

...\SD\DATA\SWAGENTD.LOG. 

Command, agent, and target log files can be viewed using the swjob command. 

LIMITATIONS 

Thefollowing PC information applies to HP OpenView Software Distributor only. 

For PCs, theSD commands generally only apply to the PC controller, or the PC depot on the PC controller. 
The swinstall and swjob commands indirectly install to and retrieve information from PC targets. 

The swpackage command is not used for PC software. PC software is packaged using the PC Console on 
the PC controller, then copied (with swcopy) to a UNIX depot for subsequent distribution. 
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FILES 

/dev/rmt/Om 

Default source tape location. 

/etc/fstab 

List of volumes that should be mounted. 

$HOME/.swdefaults 

Contains the user-specific default values for some or all SD options. If this file does not exist, SD looks 
for user-specific defaults in $HOME/ . sw/defaults. 

$HOME/.sw/defaults.hosts 

Contains the user-specific default list of hosts to manage. 

$HOME/.sw/defaults.patchfilters 

Contains the user-specific default list of patch filters. 

$HOME/.sw/sessions/ 

Contains session files automatically saved by theSD commands, or explicitly saved by the user. 

/usr/lbin/swagent 
The SD agent. 

/usr/lib/nls/$LANG/sw*.cat 

TheSD message catalogs. 

/usr/lib/sw/help/ 

The directory which contains the help files used by theSD GU Is' on-line help facility, 
/usr/lib/sw/sys.defaults 

Contains the master list of current SD options (with their default values). 

/usr/lib/sw/ui/ 

The directory which contains the description files used by theSD Graphical User I nterfaces (GUIs), 
/usr/newconfig/var/adm/sw/ 

The directory containing the configurable data shipped for the SD product, which is conditionally 
copied into /var/adm/sw/ based on the existing configuration. 

/usr/sbin/sw* 

The SD commands. 

/var/adm/sw/ 

The directory which contains all of the configurable (and non-configurable) data for SD. This directory 
is also the default location of log files. 

/var/adm/sw/defaults 

Contains the active system-wide default values for some or all SD options. 

/var/adm/sw/defaults.hosts 

Contains the system-wide default list of hosts to manage. 

/var/adm/sw/defaults.patchfilters 

Contains the system-wide default list of patch filters. 

/var/adm/sw/getdate.tempi 

Contains the set of dat^time templates used when scheduling jobs. 

/var/adm/sw/host_object 

The file which stores the list of depots registered at the local host. 

/var/adm/sw/products/ 

The I nstalled Products Database)! PD), a catalog of all products installed on a system. 

/var/adm/sw/queue/ 

The directory which contains the information about all active and complete install, remove, and other 
jobs initiated by the SD commands. Applies to HP OpenView Software Distributor only.. 

/var/adm/sw/security/ 

The directory which contains ACLs for the system itself, template ACLS, and the secrets file used to 
authenticate remote requests. 
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/var/spool/sw/ 

The default location of a source and target software depot. 

The foil owing applies to HP OpenView Software Distributor only. 

/usr/lib/sw/examples/ 

The directory containing an exampledepot and exampleswpackagedata. 

/usr/OV/help/$LANG/sd/ 

The directory which contains the help files used by theSD integration into OpenView. 

/usr/OV/registration/$LANG/sd.reg 

The registration file which integrates SD into the HP OpenView Network Node Manager. 

PC FILES 

The foil owing applies to HP OpenView Software Distributor only. 

...\SD\AGENTS\*.EXE 
The SD PC agents. 

...\SD\CONSOLE\*.EXE 
TheSD PC commands. 

. . . \SD\DATA\ 

The directory which contains all of the configurableand non-configurabledata for SD. 

. . . \SD\DATA\DEPOT\ 

The default location of the source and target PC depot. 

...\SD\DATA\NADMIN.DST 

The database which defines all PC distribution jobs and PC target status. 

...\SD\DATA\NADMIN.INV 

The database which defines all PC target machines availablefor fanout installation. 

. . . \SD\DATA\QUEUE\ 

The directory which contains the information about all active and complete install, remove, and other 
jobs initiated by the SD commands. 

...\SD\DATA\SECURITY\ 

The directory which contains ACLs for the system itself, template ACLS, and the secrets file used to 
authenticate remote requests. 

...\SD\DATA\SWAGENTD.LOG 

The log of all actions and events performed by the PC controller. 

<WINDOWS>\NADMIN.INI 

Contains the configurableoptionsfor theSD PC console. 

<WINDOWS>\SWAGENTD.INI 

Contains the configurableoptionsfor theSD PC controller. 


AUTHOR 

Software Distributor was developed by the Hewlett-Packard Company, swagent, swcopy, swin- 
stall, swlist, and swpackage were developed by the Hewlett-Packard Company and Mark H. Col¬ 
burn (see pax(l)). 

SEE ALSO 

The Managing HP-UX Software with SD-UX manual, the HP OpenView Software Distributor 
Administrator's Guide, sd(4), swacl(lM), swagentd(lM), swask(lM), swconfigflM), swcopy(lM), 
swgettools(lM), swinstall(lM), swjob(lM), swlist(lM), swmodify(lM), swpackage(lM), swpackage(4), 
swreg(lM), swremove(lM), swverify(lM). 
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NAME 

signal: signal.h - description of signals 

SYNOPSIS 

#include <signal.h> 

DESCRIPTION 

The <signal.h> header defines the following symbolic constants, each of which expands to a distinct 
constant expression of the type: 

void (*)(int) 

whose value matches no declarablefunction. 

SIG_DFL Request for default signal handling. 

SIG_ERR Return valuefrom signal () in case of error. 

SlG_HOLD Request that signal be held. 

SIG IGN Request that signal be ignored. 

The foil owing data types are defined through typedef: 

sig_atomic_t Integral type of an object that can be accessed as an atomic entity, even in the pres¬ 
ence of asynchronous interrupts 

sigset_t I ntegral or structure type of an object used to represent sets of signals, 

pid_t As described in <sys/types .h>. 

This header also declares the constants that are used to refer to the signals that occur in the system. Sig¬ 
nals defined here begin with the letters SIG. Each of the signals have distinct positive integral values. The 
value 0 is reserved for use as the null signal (see kill(2)). Additional implementation-dependent signals 
may occur in the system. 

The foil owing signals are supported on all implementations (default actions are explained below the table): 


Default 


Signal 

Action 

Description 

SIGABRT 

ii 

Process abort signal. 

SIGALRM 

i 

Alarm clock. 

SIGFPE 

ii 

Erroneous arithmetic operation. 

SIGHUP 

i 

Hangup. 

SIGILL 

ii 

Illegal instruction. 

SIGINT 

i 

Terminal interrupt signal. 

SIGKILL 

i 

Kill (cannot be caught or ignored). 

SIGPIPE 

i 

Write on a pipe with no one to read it. 

SIGQUIT 

ii 

Terminal quit signal. 

SIGSEGV 

ii 

Invalid memory reference. 

SIGTERM 

i 

Termination signal. 

SIGUSR1 

i 

User-defined signal 1. 

SIGUSR2 

i 

User-defined signal 2. 

SIGCHLD 

iii 

Child process terminated or stopped. 

SIGCONT 

V 

Continue executing, if stopped. 

SIGSTOP 

iv 

Stop executing (cannot be caught or ignored). 

SIGTSTP 

iv 

Terminal stop signal. 

SIGTTIN 

iv 

Background process attempting read. 

SIGTTOU 

iv 

Background process attempting write. 

SIGBUS 

ii 

Bus error. 

SIGPOLL 

i 

Pollable event. 

SIGPROF 

i 

Profiling timer expired. 

SIGSYS 

ii 

Bad system call. 

SIGTRAP 

ii 

Trace/breakpoint trap. 

SIGURG 

i 

High bandwidth data is availableat a socket. 

SIGVTALRM 

i 

Virtual timer expired. 

SIGXCPU 

ii 

CPU time limit exceeded. 

SIGXFSZ 

ii 

Filesize limit exceeded. 
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sigrtmin i First realtime signal. 

sigrtmax i Last realtime signal. 

The macros SIGRTMIN and SIGRTMAX evaluateto integral expressions, and specify a range that includes 
at least {RTSIG_MAX} signal numbers that are reserved for application use and for which the realtime 
signal extensions are supported (see sigaction(2)). 

The default actions are as follows: 


i Abnormal termination of the process. The process is terminated with all the consequences 
of_exit() except that the status is made available to wait () andwaitpid() indi¬ 
cates abnormal termination by the specified signal. 

ii Abnormal termination of the process. Additionally, implementation-dependent abnormal 
termination actions, such as creation of a core file, may occur. 

iii Ignore the signal. 

iv Stop the process. 

v Continue the process, if it isstopped; otherwiseignorethesignal. 

The header provides a declaration of struct sigaction, including at least the foil owing members: 


void 

(*sa_handler)(int) 

what to do on receipt of sig¬ 
nal 

sigset_t 

sa_mask 

set of signals to be blocked 
during execution of the sig¬ 
nal handlingfunction 

int 

sa_flags 

special flags 

void (*) 

(int, siginfo_t *, void *) 

sa_sigaction 

pointer to signal 
handler function 


The storage occupied by sa_handler and sa_sigaction may overlap, and a portable program must not use 
both simultaneously. 

The foil owing are declared as constants: 


SANOCLDSTOP 

SIG_BLOCK 

SIGUNBLOCK 

SIG_SETMASK 

SA_RESETHAND 


Do not generate SIGCHLD when children stop. 

The resulting set is the union of the current set and the signal set pointed 
to by the argument set. 

The resulting set is the intersection of the current set and the complement 
of the signal set pointed to by the argument set. 

The resulting set is the signal set pointed to by the argument set. 
S AON S TACK Causes signal delivery to occur on an alternate stack. 

Causes signal dispositions to be set to SIG_DFL on entry to signal 
handlers. 


SA_RESTART Causes certai n functions to become restartable. 

SA SIGINFO Causes extra information to be passed to signal handlers at the time of 

receipt of a signal. 

SA_N0CLDWAIT Causes implementations not to create zombie processes on child death. 

SA_NODEFER Causes signal not to be automatically blocked on entry to signal handler. 

SS ONS TACK Process is executing on an alternate signal stack. 

SS DISABLE Alternate signal stack is disabled. 

MINSIGSTKSZ Minimum stack size for a signal handler. 

SIGSTKSZ Default size in bytes for the alternate signal stack. 

Theucontext_t structure is defined through typedef as described in <ucontext .h> . 
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The <signal.h> header defines the stack_t type as a structure that includes at least the following 
members: 

void *ss_sp stack base or pointer 

size t ss size stack size 

int ss flags flags 

The <signal. h> header defines the sigstack structure that includes at least thefollowing members: 

int ss_onstack non-zero when signal stack is in use 
void * ss_sp signal stack pointer 

The <signal. h> header defines the sigevent structure that includes at least thefollowing members: 

int sigev_notify Notification type 

int sigev_signo Signal number 

union sigval sigevjvalue Signal value. 

The siga/_notify member specifies the notification mechanism to use when an asynchronous event occurs. 
Thefollowing values are defined for the siga/_notify member: 

SIGEV NONE No asynchronous notification will be delivered when the event of interest 

occurs. 


SI GE V_S IGNAL The signal specified in siga/_signo will be generated for the process when 

the event of interest occurs. If SA_SlGlNFO is set for that signal number, 
then the signal will be queued to the process, and the value specified in 
sigev_value will be the sigev_value component of the generated signal. If 
SA_SlGlNFO is not set for that signal number, it is unspecified whether 
the signal is queued, and what value, if any, is sent. 

The siga/_signo member specifies the signal to be generated. The siga/_value member is the application- 
defined value to be passed to the signal-catching function at the time of the signal delivery or to be returned 
at signal acceptance as the si_value member of the siginfo_t structure. 

The <signal. h> header defines sigval as a union that includes at least thefollowing members: 

int sival int I nteger signal value 
void * sivai_ptr Pointer signal value. 

The <signal. h> header defines the siginfo_t type as a structure that includes at least the following 


members: 



int 

si_signo 

signal number 

int 

si_errno 

if non-zero, an errno value 
associated with this signal, as 
defined i n <errno . h> 

int 

si_code 

signal code 

union sigval 

si_value 

signal value 

id_t 

si_pid 

sendi ng process 1D 

uid_t 

si_uid 

real user 1D of sending process 

void 

*si_addr 

address of faulting instruction 

int 

si_status 

exit valueor signal 

long 

si_band 

band event for SI GPOLL 


The si_code member contains a code identifying the cause of the signal. The following values are defined 
for si code: 


SIUSER 

SIQUEUE 
SI_TIMER 

SIASYNCIO 

SIMESGQ 


The signal was sent by kill () . The si code may be set to SI_USER also 
if the signal was sent by raise () or similar functions that are provided 
as implementation extensions of kill () . 

The signal was sent by sigqueue () . 

The signal was generated by the expiration of a timer set by 

timer_settime (). 

The signal was generated by the completion of an asynchronous I/O 
request. 

The signal was generated by the arrival of a message on an empty message 
queue. 
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If the signal was not generated by one of the functions or events listed above, the si_code will be set to an 
implementation-defined value (see below) that is not equal to any of the values defined above. 

If si code is one of SI_QUEUE, SI_TIMER, SI ASYNCIO , or SI MESGQ , then si valuewill contain the 
application-specified signal value. Otherwise, the contents of si_valueare undefined. 

The macros specified in the Code column of the following table are defined for use as values of si_code that 
are signal-specific reasons why the signal was generated. 


Signal 

Code 

Reason 

SIGILL 

ILL_ILLOPC 
ILLILLOPN 
ILL_ILLADR 
ILL_ILLTRP 
ILLPRVOPC 
ILL_PRVREG 
ILLCOPROC 

ILL_BADSTK 

illegal opcode 
illegal operand 
illegal addressing mode 
illegal trap 
privileged opcode 
privileged register 
coprocessor error 
internal stack error 

SIGFPE 

FPEINTDIV 

FPEINTOVF 

FPE_FLTDIV 

FPE_FLTOVF 

FPE_FLTUND 

FPE_FLTRES 

FPE_FLTINV 

FPE_FLTSUB 

integer divide by zero 
integer overflow 
floating point divide by zero 
floating point overflow 
floating point underflow 
floatingpoint inexact result 
invalid floating point operation 
subscript out of range 

SIGSEGV 

SEGVMAPERR 

SEGV_ACCERR 

address not mapped to object 
invalid permissionsfor mapped object 

SIGBUS 

BUS_ADRALN 

BUSADRERR 

BUSOBJERR 

invalid address alignment 
non-existent physical address 
object specific hardware error 

SIGTRAP 

TRAP_BRKPT 

TRAPTRACE 

process breakpoint 
process trace trap 

SIGCHLD 

CLD_EXITED 

CLD_KILLED 

CLD_DUMPED 

CLD_KILLED 

CLD_DUMPED 

CLD_TRAPPED 

CLDSTOPPED 

CLD_CONTINUED 

child has exited 

child has terminated abnormally and 
did not create a core file 
child has terminated and created a core file 
child was killed 

child has terminated abnormally 
traced child has trapped 
child has stopped 
stopped child has continued 

SIGPOLL 

POLLIN 

POLLOUT 

POLLMSG 

POLL_ERR 

POLLPRI 

POLLHUP 

data input available 
output buffers available 
input message available 

I/O error 

high priority input available 
device disconnected 


Implementations may support additional si_code values not included in this list, may generate values 
included in this list under circumstances other than those described in this list, and may contain extensions 
or limitations that prevent some values from being generated. Implementations will not generate a 
different value from the ones described in this list for circumstances described in this list. 

I n addition, the foil owing signal-specific information will be available: 

Signal Member Value 
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SIGILL void * si addr 
SIGFP 

SIGSEGV void * si addr 
SIGBUS 

SIGCHLD pid t si pid 
int si_status 
uid t si__uid 


SIGPOLL long si band 


address of faulting instruction 

address of faulting memory reference 

child process ID 

exit valueor signal 

real user ID of the process that sent 

the signal 

band event for P0LL_IN, 
POLL_OUT,or POLL MSG 


For some implementations, the value of si_addr may be inaccurate. 

The foil owing are declared as functions and may also be defined as macros: 


void (*bsd_signal(int sig, void (*func) (int))) (int); 
int kill (pid_t pid, int sig) ; 

int killpg(pid_t pgrp, int sig); 
int raise (int sig); 

int sigaction(int sig, const struct sigaction 
*act, struct sigaction *oact); 
int sigaddset(sigset_t *set, int signo); 

int sigaltstack(const stack_t *ss, stack_t *oss); 
int sigdelset(sigset_t *set, int signo); 
int sigemptyset(sigset_t *set); 
int sigfillset(sigset_t *set); 

int sighold(int sig); 

int sigignore(int sig); 

int siginterrupt(int sig, int flag); 

int sigismember(const sigset_t *set, int signo); 

int sigmask(int signum); 

void (*signal(int sig, void (*func) (int))) (int); 

int sigpause(int sig); 

int sigpending(sigset_t *set); 

int sigprocmask(int how, const sigset_t *set, sigset_t *oset); 
int sigqueue(pid_t pid, int sig, const union sigval value); 
int sigrelse(int sig); 

void *sigset(int sig, void (*disp) (int))) (int); 
int sigstack (struct sigstack *ss, 

struct sigstack *oss); 
int sigsuspend(const sigset_t *sigmask); 

int sigtimedwait(const sigset_t *set, siginfo_t * info, 

const struct timespec *timeout); 
int sigwait (const sigset_t *set, int *sig); 
int sigwaitinfo(const sigset_t *set, siginfo_t * info); 


APPLICATION USAGE 
Threads Considerations 

The following summarizes the signal model for threads: 

A signal mask which specifies the signals blocked from delivery is associated with each thread. 

The signal disposition, catch/ignor^default, is a process attribute and is shared by all threads in the 
process. 

If the signal action for a signal specifies termination, stop or continue, all threads within the process 
are terminated, stopped or continued, respectively. This is the case regardless of whether the signal 
was directed at the process or a specific thread within the process. 

Signals which are generated by some action associated with a particular thread, such as an invalid 
pointer dereference, will be delivered to the thread which caused the generation of the signal. These 
signals are referred to as synchronously generated signals. 
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Signals that are posted to the process by kill (2) or some asynchronous event such as terminal activity 
will be delivered to exactly one thread in the process which does not block delivery of the signal; if 
there is more than one eligible thread, which thread the signal is delivered to may not be able to be 
determined by an application. If all threads in the process block the signal, then the signal remains 
pending on the process until a thread unblocks the signal, issues a sigwait () call for the signal or 
sets the signal disposition to ignore the signal. These signals are referred to as asynchronously gen¬ 
erated signals. 

A thread can post a signal to a particular thread in the same process using pthread_kill (). If 
the thread which the signal is posted to blocks delivery of the signal, the signal remains pending on 
the thread. 

The sigpending () function returns a union of the set of signals pending on the process and on the 
cal ling thread. 

Each thread may define an alternate signal handling stack. 

LWP Considerations 

A signal mask which specifies the signals blocked from delivery is associated with each Lightweight Process 
(LWP). 

The signal disposition, catch/ignor^default, is a process attributeand is shared by all LWPs in the process. 

An LWP can post a signal to a particular LWP in the same process using lwp_kill () . If the thread 
which the signal is posted to blocks delivery of the signal, the signal remains pending on thethread. 

Each LWP may define an alternate signal handling stack. 

SEE ALSO 

alarm(2), i octl (2), ki 11 (2), sigaction(2), sigaltstack(2), siginterrupt(2), signal(2), sigpending(2), sigproc- 
mask(2), sigstack®, sigsuspend(2), sigwait®, wait®, waitid®. 

CHANGE HISTORY 

First released in Issue 1. 

I ssue 4 

The foil owing changes are incorporated for alignment with the I SO POSIX-1 standard: 

• The function declarations in this header are expanded to full ISOC prototypes. 

• The DESCRIPTION section is changed: 

- to define the type si g_atomi c_t 

- to define the syntax of signal names and functions 

- to combine the two tables of constants 

- SIGFPE is no longer limited to floating-point exceptions, but covers all erroneous arithmetic 
operations. 

The foil owing change is incorporated for alignment with the I SO C standard: 

• The raise () function is added to the list of functions declared in this header. 

Other changes are incorporated as follows: 

• A reference to <sys/types .h> is added for the definition of pid t. This is marked as an exten¬ 
sion. 

• In the list of signals starting with SIGCHLD, the statement "but a system not supporting the job 
control option is not obliged to support the functionality of these signals" is removed. This is 
becausejob control is defined as mandatory on I ssue 4 conforming implementations. 

• Reference to implementation-dependent abnormal termination routines, such as creation of a core 
file, in item ii in the defaults action list is marked as an extension. 

Issue 4, Version 2 

The following changes are incorporated for X/OPEN UNIX conformance: 

• TheSIGTRAP,SIGBUS,SIGSYS,SIGPOLL,SIGPROF, SIGXCPU, SIGXFSZ, SIGURG, and 
SIGVTALRM signals are added to the list of signals that will be supported on all conforming 
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implementations. 

• The sasigaction member is added to the sigaction structure, and a note is added that the 
storage used by sa_handler and sa_sigaction may overlap. 

• The SAONSTACK, SA RESETHAND, SA_ RESTART, SA_SIGINFO, SA_NOCLDWAIT, 
ss onstack, ssdisable , minsigstksz , and sigstksz constants are defined. The 
stack_t, sigstack, and siginfo structures are defined. 

• Definitions are given for theucontext_t, stack_t, sigstack, and siginfo_t types. 

• A table is provided listing macros that are defined as signal-specific reasons why a signal was gen¬ 
erated. Signal-specific additional information is specified. 

• The bsd_signal () , killpgO, _longjmp(), _setjmp(), sigaltstack () , sig- 
hold() , sigrelse () , sigset () , and sigstack () functions are added to the list of func¬ 
tions declared in this header. 


Section 5-316 


-7- 


HP-UX Release 11.0: October 1997 


signal (5) 


signal (5) 


HP-UX EXTENSIONS 


DESCRIPTION 

hp-ux supports multiple signal interfaces (see sigaction(2) : signal(2), sigvector(2), bsdproc(3C) : and 
sigset(3C)) that allow a process to specify the action taken upon receipt of a signal. All supported signal 
interfaces require specification of a signal, as designated by the Name and Number shown below. Signal 
specification can be any of the foil owing except SIGKILL or SIGSTOP , which cannot be caught or ignored: 


Name 

Number 

Notes 

Meaning 

SIGILL 

04 

A.B.C 

illegal instruction 

SIGTRAP 

05 

A,B,C 

trace trap 

SIGIOT 

06 

A,B 

software generated signal 

SIGEMT 

07 

A,B 

software generated signal 

SIGFPE 

08 

A,B 

floating point exception 

SIGKILL 

09 

A.D.E.F 

kill 

SIGCLD 

18 

G 

death of a child (see warnings below) 

SIGPWR 

19 

C,G 

power fail (see warnings below) 

SIGIO 

22 

G 

asynchronous I/O signal; see select(2) 

SIGWINCH 

23 

G 

wi ndow size change; see termi o(7) 

SIGURG 

29 

G 

urgent data arrived on an I/O channel 

SIGLOST 

30 

A 

file lock lost (NFS file locking) 


The letters in the Notes column in the table above indicate the action taken when the signal is received, 
and any special conditions on its use: 


A The default action is to terminate the process. 

B The default action of terminating the process also generates a core image file if possible. 

C The action is not reset to sigdfl before cal ling the signal-catching function. 

D The signal cannot be ignored. 

E The signal cannot be caught. 

F The signal will not be held off from a stopped process. 

G The default action is to ignore the signal. 

H The default action is to stop the process. 

All signal interfaces allow specification of an action that determines what to do upon the receipt of a signal, 
and should be one of the following: 

SIG_DFL Execute the default action, which varies depending on the signal as described above: 

A Terminate the receiving process with all of the consequences outlined in 
e<it(2). 

B If following conditions are met, generate a core image file (see core(4)) in the 
current working directory of the receiving process: 

• The effective user id and the real user id of the receiving process are 
equal. 

• The effective group id and the real group id of the receiving process 
are equal. 

• A regular file named core does not exist and can be created, or exists 
and is writable. 

If the file is created, it has thefollowing properties: 

• The file mode is 0666, modified by the file creation mode mask (see 
umask(2)). 

• The file user id is equal to the effective user id of the receiving pro¬ 
cess. 

• The file group id is equal to the effective group id of the receiving pro¬ 
cess. 
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G Ignore the signal. Do not terminate or stop the receiving process. 

H Stop the receiving process. While a process is stopped, any additional signals 
sent to the process are suspended until the process is restarted (except those 
marked with Note F above, which are processed immediately). Flowever, 
when the process is restarted, pending signals are processed. When a process 
that is in an orphaned process group (see glossary(9)) receives a SIGTSTP, 
SIGTTIN, or SIGTTOU signal, the process is not stopped becausea process in 
an orphaned process group is not allowed to stop. I nstead, a SIGHUP signal is 
sent to the process, and the SIGTSTP, SIGTTIN, or SIGTTOU is discarded. 

SIG_IGN Ignore the signal. 

When one of the supported signal interface routines is used to set the action of a signal to 
SIG IGN and an instance of the signal is pending, the pending signal is cleared. 

D Signals marked with Note D above cannot be ignored, 
address Catch the signal. 

Upon receipt of the signal, if signal () is used to set the action, reset the action for the 
signal caught to SIG_DFL (except signals marked with Note C). Then, call the signal- 
catching function to which address points, and resume executing the receiving process at 
the point where it was interrupted. Signal interface routines other than signal () nor¬ 
mally do not reset the action for the signal caught. Flowever, sigaction() and 
sigvector() provide a way of specifying this behavior (see sigaction(2) or sigve:- 
tor(2)). 

The signal-catching function is called with the foil owing three parameters: 
sig The signal number. 

code A word of information usually provided by the hardware. 

scp A pointer to the machine-dependent structure sigcontext defined in 

<signal.h>. 

Depending on the valueof sig, code can be zero and/or scp can beNULL. The meanings of 
code and scp and the conditions determining when they are other than zero or null are 
implementation-dependent (see dependencies below). It is possiblefor code to always 
be zero, and scp to always be null. 

The pointer scp is valid only during the context of thesignal-catching function. 

Optional parameters can be omitted from the signal-catching function parameter list, in 
which case the signal-catching function is exactly compatible with UNIX System V. Truly 
portable software should not use the optional parameters in signal-catching routines. 

Upon return from the signal-catching function, the receiving process resumes execution 
at the point where it was interrupted. 

When a signal is caught during the execution of system calls such as read(), 
write () , open () , or ioctl () on a slow device (such as a terminal, but not a file), 
during a pause () system call or a wait () system call that does not return immedi¬ 
ately because a previously stopped or zombie process already exists, the signal-catching 
function is executed and the interrupted system call returns a -1 to the calling process 
with errno settoElNTR. 

C If the signal is marked with Note C above, the action is not reset to SIG_DFL before calling 
the signal-catching function. Furthermore, the action is not reset if any signal interface rou¬ 
tine other than signal () was used to set the action. See the description of signal catching 
above. 

E If the signal is marked with Note E above, the signal cannot be caught. 

When any stop signal (SIGSTOP, SIGTSTP, SIGTTIN, SIGTTOU) is generated for a process, pending 
SIGCONT signals for that process are discarded. Conversely, when SIGCONT is generated for a process, 
all pending stop signalsfor that process are discarded. When SIGCONT is generated for a stopped process, 
the process is continued, even if the SIGCONT signal is blocked or ignored. IfSlGCONT is blocked and not 
ignored, the process remains pending until it is either unblocked or a stop signal is generated. 

SIGKILL is sent by the system if an exec () system call is unsuccessful and the original program has 
already been deleted. 
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WARNINGS 

The signals SIGCLD and SIGPWR behave differently than these described above. 

The actions for these signals is modified as follows: 

SIGCLD Setting the action for SIGCLD to SIG_IGN in a parent process prevents exiting chil¬ 

dren of the calling process from creating a zombie process. If the parent process exe¬ 
cutes the wait () function, the calling process blocks until all of the child processes 
of the calling processes terminate. The wait () function then returns a value of -1 
with errno settoECHlLD (see wait(2)). 

If one of the signal interface routines is used to set the action for SIGCLD to be 
caught (that is, a function address is supplied) in a process that currently has ter¬ 
minated (zombie) children, a SIGCLD signal is delivered to the parent process 
immediately. Thus, if the signal-catching function reinstalls itself, the apparent effect 
isthat any SIGCLD signals received due to the death of children whilethefunction is 
executing are queued and the signal-catching function is continually reentered until 
the queue is empty. Note that the function must reinstall itself after it calls wait () , 
wait3 () , or waitpid () . Otherwise the presence of the child that caused the ori¬ 
ginal signal causes another signal immediately, resulting in infinite recursion. 

When processing a pipeline, the Bourne shell (see sh-bourne(l)) makes the last pro¬ 
cess in the pipeline the parent of the preceding processes. J ob control shells including 
C shell, Korn shell and thePOSix shell (see csh(l), ksh(l), and sh-posix(l)) make the 
shell itself the parent of all processes in the pipeline. Therefore, a process that can 
receive data from a pipe should not attempt to catch SIGCLD. 

SIGPWR The SIGPWR signal is sent to all processes after a power interruption when power is 
restored and the system has done all necessary reinitialization. Processes restart by 
catching (or ignoring) SIGPWR. 

Applications that wish to recover from power failures should catch SIGPWR and take 
whatever necessary steps to reinitializeitself. 

Some implementations do not generate SIGPWR. Only systems with nonvolatile 
memory can recover from power failures. 

DEPENDENCIES 
Series 700 

The signal SIGPWR is not currently generated. 

Series 700/800 

The structure pointer sep is always defined. 

The code word is always zero for all signals except SIGILL and SIGFPE. For SIGILL, code has the fol¬ 
lowing values: 

8 I llegal instruction trap; 

9 Break instruction trap; 

10 Privileged operation trap; 

11 Privileged register trap. 

For SIGFPE, code has thefollowing values: 

12 Overflow trap; 

13 Conditional trap; 

14 Assist exception trap; 

22 Assist emulation trap. 

Refer to the Series 800 processor documentation provided with your system for more detailed information 
about the meaning of these errors. 

The I nstruction Address Offset Queue (program counter) is not advanced when a trap occurs on Series 800 
systems. If a signal generated by a hardware trap is masked or has its signal action set to SIG_IGN, the 
program loops infinitely si nee the instruction causing the trap is re-executed, causing the trap again. If the 
signal is received by a signal-catching function in the user program, the instruction that caused the trap is 
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re-executed upon return from the signal-catching function unless program flow is altered by the signal- 
catching function. For example, the longjmpO routine (see setjmp(3C)) can be called. Using 
longjmp () ensures software portability across different hardware architectures. 

AUTHOR 

signal was developed by HP, AT&T, and the University of California, Berkeley. 

SEE ALSO 

ki 11(1), init(lM), bsdproc(3C), exi t(2), ki 11 (2), lseek(2), pause(2), sigaction(2), signal (2), sigvector(2), wait(2), 
sigset(3C), abort(3C), setjmp(3C). 

STANDARDS CONFORMANCE 

<signal. h> : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FI PS 151-2, POSIX.1, ANSI C 
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NAME 

sis - secure internet services with Kerberos authentication and authorization 

DESCRIPTION 

Secure Internet Services (SIS) provides network authentication when used in conjunction with HP DCE 
security services, the HP Praesidium/Security Server, or other software products that provide a Kerberos 
V5 Network Authentication Services environment. The network authentication ensures that a local and 
remote host will be mutually identified to each other in a secure and trusted manner and that the user is 
authorized to use the service on the remote host. 

Traditional internet services such as telnet, rlogin, or ftp, allow the user to access remote systems 
by typing a password that is then transmitted to the remote system over the network. The password is 
transmitted without encryption over the network, permitting an observer to capture the cleartext packets 
containing the password. This has been a major security hole for traditional internet services. 

The optional Secure Internet Services area replacement for their traditional counterparts and prevent the 
cleartext transmission of user passwords over the network. However, none of these services will encrypt 
the session beyond what is necessary to authenticatethe service or authorize the user. 

This man page assumes the reader is familiar with Kerberos terminology normally provided with your Ker¬ 
beros V5 Network Authentication Services environment. Theintent here is to describe those aspects of the 
Kerberos environment specifically used by SIS. 

Authentication 

For Kerberos authentication to succeed, the user must have successfully logged into a system within the 
Kerberos realm and obtained a set of credentials. The credentials include a Ticket Granting Ticket (TGT) 
and a session key. TheSIS client will usetheTGT to obtain a service ticket to access a SIS daemon on the 
network. If the credentials are missing or the TGT is invalid, the authentication will fail and connection to 
theSIS daemon will be denied. 

For systems configured into a DCE cell, credentials are obtained through the dce_login command. For 
systems configured into a Praesidium/Security Server cell, credentials are obtained through the 
dess_login command. In a non-DCE Kerberos-based secure environment, credentials are obtained 
through the kinit command. 

Authorization 

For every user of these services, a user principal must be configured into the Key Distribution Center's 
database. The user principal allows the user to obtain a service ticket which is sent to the remote service 
as part of the Kerberos authentication mechanism. If the authentication is successful, the user principal is 
then used as part of the Kerberos authorization mechanism. 

In order for the authorization to succeed, both of the foil owing requirements must be met: 

1. The login name must exist in the remote system's password file, i.e, the remote account must exist. 
Note: the login name is the name specified by the user in response to a login prompt and may be 
different from the current user name. 

2. One of thefollowing conditions must be true: 

A. The remote account's home directory has a .kSlogin file that contains the user principal. 
The . kSlogin file must be owned by that account and only that account can have write per¬ 
mission (i.e., the permissions would appear as-rw-r-r-). 

B. The remote system has an authorization name database file, aname, that contains the user prin¬ 
cipal. The aname file should contain a mapping of the user principal to an account on the 
remote system. 

C. The user name in the user principal is the same as the user name of the account being accessed, 
and the local and remote systems are in the same realm. 

If authorization succeeds, the user will not see a prompt for a password (when a password is required) and 
the connection to the remote system will succeed. If the authentication or authorization fails, the user will 
be notified of the error and will not be allowed to continue. 

Bypassing or Enforcing Authentication/Authorization 

If the authentication or authorization fails, the service can be re-run with a special command lineoption (- 
P) to request non-Kerberos authentication. However, when a password is required, it will be sent across 
the network in a readable form. Typically, this special command lineoption should only be used to access 
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non-secure remote systems. 

The ftp and telnet daemons have a special command line option (-A) which can be used to ensure that 
non-secure systems are denied access. 

To prevent non-secure access through the rep, remsh or rlogin commands, the inetd.conf file on the 
remote system should be edited to comment out the entries for shell and login. 


SERVICES 

ftp, ftpd 

rlogin, rlogind 
telnet, telnetd 
rep, remshd 
remsh, remshd 

TROUBLESHOOTING 

For the correct execution of SIS, it is important that the secure environment be properly installed, 
configured and running. The following is a quick checklist to verify this: 

1. The DCE, Praesidium/Security Server, or Kerberos security system should be running on the Ker¬ 
beros server. The /etc/services file should contain entries for the Kerberos ports. 

2. The user's user principal must be entered into the Key Distribution Center's database. Use the 
appropriate tool (eg., kadmin or H P DCE's dcecp) to list the database and to verify that the user 
has a user principal configured. 

3. The Kerberos configuration directory on the local and remote systems should contain a krb.conf, 
krb.realms, and a server key table file. Generally, the Kerberos configuration directory will be 
/krb5 and the server key table file wi 11 be named vSsrvtab. 

4. The user principal must be specified in ~/.k51ogin on the local and remote systems. The 
~/.k51ogin lists the principals and realm names which have access permission for the user's 
account. 

Alternatively, the secure system can use an authorization name database, aname, on the local and 
remote systems. An entry in this file will authorize the user name in a user principal to the specified 
login name. 

Verify that "/ . kSlogin exists, has the correct permissions (i.e., -rw-r--r--), and includes the user 
principal. Or, use the appropriate tool (eg., krb5_anadd on a non-FIP DCE system) to verify that 
the user principal is included in the aname file. 

5. The server key table file on the remote system should contain a host principal. The root user can ver¬ 
ify the contents of the v5srvtab through the command: klist -k. If klist supports the -k 
option, type this command and verify that a host principal is listed. 

Alternatively, if the validation tool, krbval, is availableon the system, use the command: krbval 

—V. 

6 If krbval is availableon the local and remote systems, use it to test the Kerberos configuration by 
invoking it to act as a client application on the local system and a server application on the remote 
system. See krbval (1M) for details. 

7. The SI S files must be installed. The traditional services will have been saved and the files for the new 
services will be linked to the original, traditional file names. 


file transfer program 
remote login 

user interface and server for Telnet protocol 

remote file copy 

execute from a remote shell 


DIAGNOSTICS 

In addition to Kerberos-specific error messages, SIS has a few security related error messages that are 
common to several or all of the services. These error messages can be used by scripts to detect whether the 
invocation of a service has failed. 


Error and warning messages reported by theSIS clients 
ERROR! Kerberos authentication failed. 

The user has not obtained a valid Ticket Granting Ticket (through kinit, dce_login, or 
dess_login) or a valid host principal has not been configured in the Key Distribution Center's 
database for the realm. A more specific error message indicating the possible cause of the failure will 
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accompany this error message. 

This error message will also be generated if the user attempts to access a non-secure remote system. 

I n which case, this message will be preceded by the message: "To bypass Kerberos authentication, use 
the -P option". 

This error is reported by ftp, rlogin and telnet. 

ERROR! Kerberos-specific options are invalid with the -P option. 

The -P command line option indicates that Kerberos authentication should not be performed. If any 
Kerberos-specific options are also specified on the command line, then they are in contradiction to this 
request. 

Forremshand rlogin, this means the -P option can not be used in conjunction with the -F, -f 
or -k options. 

For rep this means the -P option can not be used in conjunction with the -k option. 

For telnet, this means the -P option cannot be used in conjunction with the -a or -1 options. 
WARNING! Password will be sent in a non-secure manner. 

WARNING! Kerberos authentication will be bypassed. 

The user has specified the -P option on the command line to access a non-secure remote system or to 
bypass a bad configuration in the Kerberos environment. 

In the cases where a password is requested, the -P command line option will cause the password to 
be sent across the network in a readableform where it could possibly be intercepted or captured. 

It is recommended that the user corrects a bad configuration and only uses the -P option if the 
remote system is non-secure. 

The first warning is reported by ftp, rlogin, and telnet. The second warning is reported by 
rep. remsh could report either warning depending upon whether a password is required. 

Error messages reported in the syslog by the SIS daemons 

ERROR! Access denied. Kerberos authentication must succeed. 

The daemon was started with the -A command line switch to ensure that non-secure access by 
remote systems will be denied. The user cannot access the remote system unless the local system has 
been configured for secure access. 

This error is logged by ftpd and telnetd. 

ERROR! Principal <principal> (<remote_user>@<remote_host>) logging in 
as <local_user> has no account. 

The "local_user" does not have a valid password file entry. 

Thiserror is logged by all SIS daemons. 

ERROR! Principal <principal> (<remote_user>@<remote_host>) logging in 
as <local_user> failed krb5_userok. 

Authentication succeeded but authorization failed. The user should verify that their user name is 
listed in ~/.k51ogin or in the aname file on the remote system. Theuser's ~/.k51ogin must 
have the correct permissions and must be owned by the user (i.e., -rw-r-r-). 

Thiserror is logged by all SIS daemons. 

ERROR! Principal <principal> (<remote_user>@<remote_host>) logging in 
as <local_user> failed ruserok. 

The /etc/hosts . equiv or ~/. rhost files are missing or are not set up properly to authorize 
"local_user" (seeruserok(3N)). 

This error is logged by rlogind or remshd if they are started with the -R, -r or -k options. 

SEE ALSO 

ftp(l), kinit(l), kdestroy(l), klist(l), krbval(lM), rcp(l), remsh(l), rlogin(l), telnet(l), dce_intro(lM), 
dceJogin(lM), dessJogin(lM), ftpd(lM), remshd(lM), rlogind(lM), telnetd(lM), dess(5). 
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NAME 

sys/stat.h - data returned by the stat() function 

SYNOPSIS 

#include <sys/stat.h> 

DESCRIPTION 

The <sys/stat.h> header defines the structure of the data returned by the functions fstat() , 
lstat () , and stat () . The structure stat contains at least the following members: 


devt 

stdev 

ID of device containing file 

ino_t 

st_ino 

file serial number 

mode t 

st_mode 

mode of file (see below) 

nlink_t 

st_nlink 

number of links to thefile 

uid_t 

st_uid 

user 1D of file 

gid_t 

st_gid 

group ID of file 

devt 

st_rdev 

device ID (if file is character or block special) 

off_t 

st_size 

file size in bytes (if file is a regular file) 

time_t 

st_atime 

time of last access 

time_t 

stmtime 

time of last data modification 

time_t 

st_ctime 

time of last status change 

long 

st_blksize 

a filesystem-specific preferred I/O block size 
for this object. 1 n some filesystem types, this 
may vary from file to file 

long 

st_blocks 

number of blocks of a filesystem-specific size 
allocated for this object 


File serial number and device ID taken together uniquely identify the file within the system. The dev_t, 
ino_t, mode_t, nlink_t, uid_t, gid_t, off_t, and time_t types are defined as described in 
<sys/types .h>. Times are given in seconds sincetheEpoch. 

The foil owing symbolic names for the values of st_mode are also defined: 

File type: 


S_IFMT 

type of file 

S_IFBLK 

block special 

S_IFCHR 

character special 

S_IFIFO 

FIFO special 

SIFREG 

regular 

S_IFDIR 

directory 

S_IFLNK 

symbolic link 

File mode bits: 

S_IRWXU 

read, write, execut^search by owner 

S_IRUSR 

read permission, owner 

SIWUSR 

write permission, owner 

S_IXUSR 

execut^search permission, owner 

S_IRWXG 

read, write, execut^search by group 

SIRGRP 

read permission, group 

SIWGRP 

write permission, group 

SIXGRP 

execut^search permission, group 

S_IRWXO 

read, write, execut^search by others 

S_IROTH 

read permission, others 

S_IWOTH 

write permission, others 

S_IXOTH 

execut^search permission, others 

S_ISUID 

set-user-1 D on execution 

S_ISGID 

set-group-1 D on execution 

S_ISVTX 

on directories, restricted deletion flag 


The bits defined by s_irusr, s_iwusr, s_ixusr, s_irgrp, s_iwgrp, s_ixgrp, s_iroth, 
s_iwoth, s_ixoth, s_isuid, s_isgid and s_i svtx are unique. s_irwxu is the bitwise OR of 
s irusr, s iwosr, and s ixusr. s irwxg is the bitwise OR of s_irgrp, s_iwgrp, and 
sixgrp . sirwxo is the bitwise OR of s_iroth, s_iwoth, ands_ixoTH. 
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Implementations may OR other implementation-dependent bitsintoS_IRWXU, S_IRWXG, and S_IRWX0, 
but they will not overlap any of the other bits defined in this document. The file permission bits are defined 
to be those corresponding to the bitwise inclusive OR of S_IRWXU, S_IRWXG, and S_IRWX0. 

The foil owing macros will test whether a file is of the specified type. The value m supplied to the macros is 
the value of st_modefrom a stat structure. The macro evaluates to a non-zero value if the test is true, 0 if 
thetest isfalse. 


s_iSBLK(m) Test for a block special file. 
s_ischr (m) Test for a character special file. 
s__isdir( m) Test for a directory. 


S_ISFIFO(m) 
S_ISREG(m) 
S_ISLNK (m) 


Test for a pipe or FIFO special file. 
Test for a regular file. 

Test for a symbolic link. 


The foil owing are declared as functions and may also be defined as macros: 


int chmod(const char *path, mode_t mode); 

int lstat(const char *path, struct stat *buf); 

int mkdir(const char *path, mode_t mode); 

int mkfifo(const char *path, mode_t mode); 

int mknod(const char *path, mode_t mode, dev_t dev); 

int stat(const char *path, struct stat *buf); 

modest umask(mode_t cmask); 


APPLICATION USAGE 

Use of the macros is recommended for determining thetype of a file. 

SEE ALSO 

chmod(), fchmodO, fstat(), IstatQ, mkdir(), mkfifo(), mknod(), stat(), umask(), <sys/types.h>. 

CHANGE HISTORY 

First released in Issue 1. 

Derived from Issue 1 of the SVID. 


I ssue 4 

The following changes are incorporated for alignment with the ISO POSIX-1 standard: 

• The function declarations in this header are expanded to full I SO C prototypes. 

• The DESCRIPTION section is expanded to indicate (a) how files are uniquely identified within the 
system, (b) that times are given in units of seconds since the Epoch, (c) rules governing the 
definition and use of the file mode bits, and (d) usage of the file type test macros. 

Other changes are incorporated as follows: 

• Reference to the header <sys/types.h> is added for the definitions of da/_t, ino_t, mode_t, nlink_t, 
uid_t, gid_t, off_t, andtime_t. This has been marked as an extension. 

• References to the S_IREAD, S__IWRITE, S_IEXEC file and S_ISVTX modes are removed. 

• The descriptions of the members of the stat structure in the DESCRIPTION section are 
corrected. 


Issue 4, Version 2 

The following changes are incorporated for X/OPEN UNIX conformance: 

• The st blksizeand st blocks members are added to the stat structure. 

• The S_IFLINK value of S_IFMT is defined. 

• The S ISVTX file mode bit and the S_ISLNK file type test macro is defined. 

• Thefchmod(), lstat () , andmknod() functionsareaddedtothelistof functions declared in 
this header. 
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HP-UX EXTENSIONS 


NAME 

stat.h - file-specific information 

DESCRIPTION 

The contents of the stat structure include the foil owing members: 
ushort st_fstype; /*Type of filesystem this file */ 

/* is in; see vfsmount(2) */ 

dev_t st_realdev; /* Real device number of device*/ 

/* containingthe inode for this fil e */ 

The foil owing symbolic names for the values of the st_mode field are defined as indicated: 
File type: 

S IFMT 0170000 type of file 
S I FSOCK 0140000 socket 
S IF L N K 0120000 symbol i c I i n k 
SJFNWK 0110000 network special 
SjFREG 0100000 regular (ordinary) 

S IF B L K 0060000 bl ock sped a I 

S_lFDIR 0040000 directory 

SJFCFIR 0020000 character special 

Sj FIFO 0010000 FIFO special (named pipe) 

File mode bits: 

File miscellaneous mode bits: 


S_CDF 0004000 directory is a context-dependent file 
S ISUID 0004000 set user id on execution 
SJ SGI D 0002000 set group id on execution 
S_enfmt 0002000 set file-locking mode to enforced 
S ISVTX 0001000 save swapped text even after use 

F i I e permi ssi on mode bi ts: 

S IRWXU 0000700 owner's file access permission bits 
S IRUSR 0000400 read access permission for owner 
S IWUSR 0000200 write access permission for owner 
SjxusR 0000100 execute/search access permission for owner 
S IRWXG 0000070 group's file access permission bits 
S IRGRP 0000040 read access permission for group 
S IWGRP 0000020 write access permission for group 
S IXGRP 0000010 execute/search access permission for group 
S IRWXO 0000007 others'access permission bits 
Sj ROTH 0000004 read access permission for others 
SJWOTH 0000002 write access permission for others 
SJXOTH 0000001 execute/search access permission for others 

Obsolete names for file permission mode bits: 

S i read 0000400 read access permission for owner 

SJ WRITE 0000200 write access permission for owner 

S i exec 0000100 execute/search access permission for owner 

File type test macros: 

SjSCDF(m) test for a context-dependent file 
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SjSNWK(m) test for a network special 
SjssoCK(m) test for a socket 


SEE ALSO 

chmod(2), chown(2) : link(2), mkdir(2), mkfifo(2), mknod(2), stat(2), symlink(2) : umask(2) : utime(2), types(5). 

STANDARDS CONFORMANCE 

<sys/stat.h >: AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1 
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NAME 

stdarg.h - macros for handling variableargument lists 

SYNOPSIS 

#include <stdarg.h> 

void va_start(va_list pvar, argN); 
type va_arg(va_list pvar, type); 
void va_end(va_list pvar); 

DESCRIPTION 

The <stdarg.h> header contains a set of macros that can be used to write portable procedures that accept 
variable argument lists. Routines that have variable argument lists (such as printf () ) but do not use 
stdarg are inherently nonportable, because different machines use different argument-passing conventions. 

va_list is a type defined for the variable used to traverse the list. 

va_start is called to initialize pvar to the beginning of the list. The type of argN should be the same as the 
argument to the function just before the variable portion of the argument list. 

va_arg returns the next argument in the list pointed to by pvar. type is the type the argument is expected 
to be. Different types can be mixed, but it is up to the routine to know what type of argument is expected, 
because it cannot be determined at runtime. 

va_end is used to clean up. 

Multipletraversals, each bracketed by va start ... va_end, are possible. 

EXAMPLE 

This example is a possible implementation of execl (see o<ec(2)): 

#include <stdarg.h> 

#define MAXARGS 100 

/* execl is called by 

execl(file, argl, arg2, . .., (char *)0); 

*/ 

execl(const char *file, const char *args, ...) 

{ 

va list ap; 

char ‘array[MAXARGS]; 

int argno = 0; 

va start(ap, args); 
if ((array[0] = args) != 0) 

while ((array[argno+t] = va arg(ap, char *)) != 0) 

va end(ap); 

return execv(file, array); 

) 

SEE ALSO 

exec(2), vprintf(3S), varargs(5). 

WARNINGS 

It is up to the calling routine to specify how many arguments there are, since it is not always possibleto 
determine this from the stack frame. For example, execl () is passed a zero pointer to signal the end of 
the list, and printf () can tell how many arguments are there by theformat string. 

Unless ansi C is used, it is non-portable to specify a second argument of char, short, or float to va_arg, 
because arguments seen by the called function are never char, short, or float. 

Pre-ANSI C converts char and short arguments to int and converts float arguments to double before passing 
them to a function. 
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STANDARDS CONFORMANCE 

<stdarg.h>: AES, SVID3, XPG4, FIPS 151-2, POSIX.1, ANSI C 

va„arg: SVID3, XPG4, ANSI C 
va_end: SVID3, XPG4, ANSI C 
va_list: SVI D3, XPG4, ANSI C 
va_start: SVI D3, XPG4, ANSI C 
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NAME 

stdsyms- description of HP-UX header file organization 

DESCRIPTION 

HP-UX header files are organized in a manner that allows for only a subset of the symbols availablein that 
header file to be visible to an application that conforms to a specific standard. The ANSI-C, POSIX.1, 
POSIX.2, and XPG4 standards each reserve a certain set of symbols for that standard's namespace. In 
addition, the HP-UX implementation of XPG3 and the "OSF AES/OS" provides for a clean namespace 
although this is not a specific requirement of those standards. 

The following rules apply in determining what symbols are reserved for any standard. These symbols are 
reserved for the standard and for use by the implementation, and must be either avoided altogether, or 
used exactly as defined by the specified standard. 

• All symbols defined by the desired standard are reserved. Refer to the appropriate standards docu¬ 
mentation for a complete list of reserved symbols. 

• All symbols beginning with an underscore followed by another underscore or an uppercase letter 
are reserved for the implementation. 

• All external identifiers beginning with an underscore are reserved for the implementation. 

The following is a list of feature test macros which must be defined to obtain the appropriate namespace 
from the header files. 

_STDC_ 

This symbol is automatically defined by the ANSI-C preprocessor 
(/opt/langtools/lib/cpp. ansi) and is automatically defined when specifying an 
ANSI-C compile (cc -Aa). Using the strict ANSI option -Aa requests a pure ANSI-C 
namespace, which is the smallest subset of the HP-UX namespace available. The -Aa 
option also enables the inclusion of ANSI-C-style function prototypes for increased type 
checking. Note that the default namespace when using the -Aa option is the ANSI-C 
namespace; therefore a broader namespace must be requested if it is desired. 

POSIXSOURCE 

As documented in the IEEE POSIX.1 standard, the programmer is required to define the 
_POSlX_SOURCE feature test macro to obtain the POSIX.1 namespace and POSIX.1 func¬ 
tionality. This feature test macro can be defined, either by using compiler options (- 
D POSIX SOURCE) or by using #define directives in the source files before any 
#include directives. Note that the default POSIX namespace is the POSIX.1-1990 
namespace. It is necessary to define the _P0SIX1_1988 feature test macro in addition 
to the POSIXSOURCE macro in order to obtain the POSIX.1-1988 namespace. 

_POSIX_C_SOURCE 

As documented in the IEEE POSIX.2 standard, the programmer is required to define the 
_P0SIX_C_S0URCE feature test macro with a value of 2 to obtain the POSIX.1 and 
POSIX.2 namespaces and functionality. This feature test macro can be defined, either by 
using compiler options (-D_POSIX_C_SOURCE=2) or by using #define directives in 
the source files before any #include directives. This macro is also automatically defined 
in the XPG4 X/Open namespace (that is, whenever _XOPEN_SOURCE and _XPG4 are 
defined without defining _XPG2 or_XPG3). 

XOPEN SOURCE 

As documented in theXPG3 and XPG4 standards, the programmer is required to define the 
_XOPEN SOURCE feature test macro to obtain X/Open functionality. This feature test 
macro can be defined, either by using compiler options (-D_XOPEN_SOURCE) or by using 
#define directives in the source files before any #include directives. Although XPG3 
does not specify any namespace pollution rules, XPG4 has instituted such rules. Therefore, 
the HP-UX operating system provides clean namespaces whenever _XOPEN_SOURCE is 
defined. 

The current default X/Open namespace is that corresponding to XPG3. To request other 
versions of the X/Open namespace, define _XPG2 or _XPG4 in conjunction with 

XOPEN SOURCE. 

„AES_SOURCE 

As documented in the "OSF AES/OS" standard, the programmer is required to define the 
_AES_SOURCE feature test macro to obtain OSF functionality. This feature test macro 
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can be defined, either by using compiler options (-D__AES_SOURCE) or by using 
#define directives in the source files before any #include directives. Although the 
AES does not specify any namespace pollution rules, the other standards have instituted 
such rules. Therefore HP-UX provideds a clean namespace whenever _AES_SOURCE is 
defined. 

_HPUX_SOURCE 

The programmer can define the _HPUX_SOURCE feature test macro to obtain the HP-UX 
namespace and complete HP-UX functionality. Note that the HP-UX namespace is 
currently a superset of all of the above mentioned namespaces. When using the 
compatibility-mode compiler (cc(l) without the -Aa option), the HP-UX namespace is pro¬ 
vided by default. The programmer must request one of the other namespaces as described 
above to obtain the appropriate subset of the HP-UX namespace. When using the strict 
ANSI-C-mode compiler (cc -Aa), the programmer must specifically request a broader 
namespace. 

The _HPUX_SOURCE feature test macro can be defined, either by using compiler options 
(—D_HPUX_SOURCE) or by using #define directives in the source files before any 
jfinclude directives. 

The foil owing is a list of miscellaneous feature test macros that provide various additional features. 

_cplusplus 

This symbol is automatically defined by the HP C-H-compiler. Defining this macro enables 
the C++function prototypes in system header files. 

The default namespace for HP C++ is the ANSI-C namespace. To obtain another 
namespace define the appropriate feature test macro. 

HP C++uses the ANSI-C preprocessor by default. Toget the compatibility mode preproces¬ 
sor, use the -Ac option to cc(l). The compatibility mode preprocessor uses the HP-UX 
namespace (_HPUX_SOURCE). 

_P0SIX1_1988 

This feature test macro should be defined when the POSIX. 1-1988 namespace is 
required. It should be used in conjunction with the _POSlX_SOURCE macro if the 
default POSIX. 1-1990 namespace is not desired. 

This macro is defined automatically whenever _AES_SOURCE or _XPG3 is requested. 

_XPG2 The _XPG2 macro can be defined when using the compatibility-mode compiler to obtain 
XPG2 functionality. This provides XPG2 specified function declarations and macros in the 
HP-UX namespace. Note that the values obtained from most of the macros available when 
using this option are now available at run-time via the pathconf () , fpathconf () , 
andsysconf() system calls (see pathconf(2) and sysconf(2)). Use of the _XPG2 macro 
is strongly discouraged because it gives access to obsolete functionality. Note that no func¬ 
tion prototypes are provided when using this feature test macro. 

_XPG3 The _XPG3 feature test macro is defined automatically if the programmer has requested 
the XPG3 namespace (i.e., defined _XOPEN_SOURCE, but not some other conflicting 
namespace such as _XPG2 or_XPG4). 

_XPG4 The _XPG4 feature test macro is provided so that the programmer can obtain the XPG4 
namespace, since it differs slightly from the _XPG3 namespace. In order to obtain the 
XPG4 namespace, the programmer must define both the _XOPEN_SOURCE and _XPG4 
feature test macros. The _XOPEN_SOURCE and _XPG4 feature test macros can be 
defined, either by using compiler options (-D_XOPEN_SOURCE -D_XPG4) or by using 
#define directives in the source files before any #include directives. 

_SVID2 The _SVID2 macro can be defined when using the compatibility mode compiler to obtain 
SVID2 function return types in the HP-UX namespace. The default return types of many 
functions have since been changed in the HP-UX operating system to align with the ANSI- 
C, POSIX, X/Open, and OSF standards. 

CLASSICTYPES 

The CLASSIC TYPES macro can be defined by the programmer to obtain pre-7.0 style 
function return types and structure element types. This macro has been provided only as a 
transition aid when migrating from the pre-7.0 version of HP-UX to standards-based HP- 
UX. Use of this macro is strongly discouraged as this functionality will be removed in a 
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future release of HP-UX. Note that no function prototypes are provided when using this 
feature test macro. 


SEE ALSO 

cc(l), cpp(l), pathconf(2), sysconf(2). 
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NAME 

suffix - file-name suffix conventions 

DESCRIPTION 

The following list summarizes file name suffix conventions that can be found in an hp-ux system. It is a 
partial compilation of possibly useful knowledge, suggestions, and explanations, rather than a specification 
of standards. Suffixes are often used in preference to prefixes because they enable related files to group 
together alphabetically in a directory listing. 

Note that some programs require the use of a specific value, or vary their behavior based on a choice of 
suffixes. Such programs are noted in many (but not all) cases. 

.A HP64000cross assembler symbol fiIe. 

.a Library file (archive) managed by ar; known to make. 

.ad? HP Ada source, where "?" stands for any single character. 

.allow List of users allowed by at or cron (for example, at.allow). 

.an Source for nroff "man" macros. 

.ASC lif (Logical I nterchange Format) type 1, ascii file for use by Pascal or basix/ux. Incompa¬ 

tible with lifcp. 

.aux Cross-referencing information created automatically by LaTeX. 

.awk awk script file. 

.b Compiled lisp (.1) source file, or a bold font file. 

.back 

.bak 

.bkup Backup copy of a file. 

.BAD 

.bad Filecontaining bad data, or occupying a bad spot on a disk. 

.bbl Bibliography created by BibTeX for inclusion in a LaTeX document. 

.bib Bibliographic data file, (for example, BibTeX bibliography database). 

.big Log of errors from BibTeX. 

.bst BibTeX bibliography style definition. 

.C File compressed by compact, or C++ language source file, or HP64000 cross compiled C 

source file. 

.c C language source file; known to cc and make. 

.cas cast languagescripts. 

.cat nls (Native Language Support) message catalog. 

.cf Configuration file (for example, sendmail.cf). 

.du CLU file. 

.code Pascal workstation object code. 

.cpio Filecontaining output from cpio -o, that is, a cpio archive. 

.csh C-shelI (csh) script. 

.curr Current version of a file. 

.d Directory file, or data file. 

.day A script that is read daily. 

.deny List of users denied by at or cron (for example, cron.deny). 

.devs L i st of devi ces. 

.diff Differences between two files, output from diff. 
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.dir 

.doc 

.dvi 

.e 

.el 

.elc 

.eqn 

.err 

.errors 

.errs 

.f 

,f77 

.fc 

.full 

.gf 

.glo 

.h 

.help 

.hf 

.hip 

.hour 

.hr 


.icn 

.idx 

.in 

.INDEX 

.ksh 

.L 


■LIST 

.list 

.In 

.lof 

■log 

.lot 

.m 

.m2 

.make 

.mk 

.man 

.me 


dbm database directory file. 

Documentation file of some sort. 

Device-independent text formatter output. 

Extended fortran language(EFL) source file; known to make. 
gnu Emacs Elisp file. 

Compiled gnu Emacs Elisp file. 

Source for nroff equation macros. 

Standard error from a program. 

E rrors recorded by a program. 

fortran language source file; known tofcand make. 

fortran 77 language source file. 

Frozen configuration file (for example, sendmail.fc). 

A complete file or list. 

TeX font bitmaps in Generic Font format. 

Glossary created by LaTeX. 

C language header (include) file; known to make. 


FHelp text for a program, often read automatically. 

A script that is read hourly. 

Output of C preprocessor ("cc -P"), or a Berkeley Pascal language include file, or an itali¬ 
cized font file. 

I con source code. 

I ndex created by LaTeX. 

Standard input to a program, 
notes index file. 

Korn shell script file. 

FIP64000cross linker symbol file. 

Is< source file (known to make), or lisp source file, 
notes list file. 

Filecontaininga list of other files. 

Library information for lint. 

List of figures created by LaTeX. 

Generic log file, or a log of error messages from TeX. 

List of tables created by LaTeX. 

Modula language source file. 

Modula-2 language source file. 

Makefile for make. 

Source for nroff or troff using man macros. 

Source for nroff or troff using me macros. 
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.mf 

.ml 

.mm 

.mon 

.month 

.ms 

.n 

.NEW 

.new 

.nro 

.O 

.o 

.obs 

.OLD 

.old 

.opt 

.orig 

.out 

.P 

■P 

.pag 

■Pi 

.pk 

.prev 

.ps 

.pxl 

.R 

.r 

.rc 

.real 

.req 

.S 

.s 

.safe 

.save 

.scm 

.sh 

.shar 

.skel 

.si 

.st 


TeX metafont input file. 

Gosling/U nipress Emacs Mock Lisp file. 

Source for nroff or troff using mm macros. 

A script that is read monthly. 

Source for nroff or troff using ms macros, 
nroff source. 

New version of a file, 
nroff source. 

HP64000listingfile. 

Relocatable object file (post-compile, pre-link); known to as, cc, fc, pc, and make. 

Obsolete version of a file. 

Old version of a file. 

Filecontaining optional material, such as an optional part of thekernel. 

Original version of a file. 

Standard output (and possibly standard error) from a program (for example, nohup.out), or 
an executable file output from Id (such as a.out). 

FI P64000 cross compiled Pascal source file. 

Pascal language source file (known to pc and make), or PROLOG languagesourcefile. 
dbm database data file. 
pilot languagesourcefile. 

TeX font bitmaps in Packed Font format; denser/more recent than GF. 

Previous version of a file. 

PostScript files. 

TeX font bitmaps in uncompressed format; very obsolete. 

FI P 64000 rel ocata ble file. 

RatFor languagesourcefile; known to make. 

A "run commands" file, normally read when a program is invoked (for example, mailx.rc). 

Real version of a file, often one which was replaced by a front-end (for example, 
uucico.real). 

Filecontaining required material, such asa required part of thekernel. 

FIP64000 cross assembled source file. 

Assembler input file; known to cc and make. 

Safe or saved copy of a file. 

Scheme file. 

Bourne shell script file; known to make. 

Shell archive file containing output from shar. 

Skeletal or template file. 

Shared library file built by ld(l);knownto Id(1). 

File containing statistics (for example, /etc/mail/sendmail.st). 
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.sty 

■SYSTM 


■t 

.tar 

.tbl 

.temp 

.tmp 

.template 

.test 

■tex 

■TEXT 

.text 

■txt 

.tfm 

.toe 

.tro 

■ul 

.u2 

.ux 

.web 

.week 

.wk 

■X 

■y 

■Z 

.z 

.1 .. .8 

,<date> 


,v 


LaTeX style definition; should have a corresponding .doc file. 

lif Bootable by the Series 300/400 boot ROM (see Librarian chapter of Pascal 3.2 Worksta¬ 
tion System, vol. 1). 

Text file. 

File (archive) containing output from tar. 

Source for nroff table macros. 

Temporary file. 

Prototype or template file. 

Test input or output file. 

TeX source file. 

notes text file, or a Pascal workstation "UCSD text format" file. 
ascii text file. 

Width information used by TeX (TeX font metrics). 

Source for nroff table of contents macros, or table of contents created by LaTeX. 
troff source. 

Icon intermediate code files. 

HP-UX text or binary file format. 

Web file (Knuth's Web system). 

A script that is read weekly. 

H P 64000 absol ute fil e. 
yacc input file; known to make. 

File compressed by compress. 

F iIe compressed by pack. 

Manual entry files (sections 1 through 8), optionally followed by a letter a..z. 

File saved on given date (year, month name, YYMM, MMDD, etc.) as a snapshot of a 
continuously-growing logfile. 

RCS delta file; known to theRCS programs. 


AUTHOR 

suffix was developed by H P. 
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NAME 

term.h — terminal capabilities 

SYNOPSIS 

#include <term.h> 

DESCRIPTION 

The following data type is defined through typedef: 

terminal An opaque representation of the capabilities for a single terminal from the terminfo 
database. 

The <term.h> header provides a declaration for the following object: cur_term . It represents the 
current terminal record from the terminfo database that the application has selected by calling 
set_curterm() . 

The <term.h> header contains the variable names listed in the Variable column inthetablein Defined 
Capabilities in terminfo(4). 

The foil owing are declared as functions, and may also be defined as macros: 

int del_curterm(TERMINAL *Oterm) ; 

int putp(char ‘const Str); 

int restartterm(char *term, int fildes, int *errret) ; 

TERMINAL * set_curterm (TERMINAL *nterm) ; 

int setupterm(char *term, int fildes, int *errret) ; 

int tgetent (char *bp, char ‘const name) ; 

int tgetflag(char id[2]); 

int tgetnum(char id [2]); 

char * tgetstr(char id [2], char “area); 

char * tgoto(char ‘const cap, int COl , int row); 

int tigetflag (char ‘capname) ; 

int tigetnum(char ‘capname) ; 

char * tigetstr (char ‘capname); 

char * tparm(char ‘cap, long pi, long p2, long p3, long p4, 

long p5, long p6, long p7, long p8, long p9) ; 
int tputs (char ‘const Str, int affcnt, int (‘putfunc) (int)); 

SEE ALSO 

terminfo(4), printf(), putp(), tigetflagO, tgetent(), <curses.h>. 

CHANGE HISTORY 

First released in X/Open Curses, Issue4. 


HP-UX Release 11.0: October 1997 


1 - 


Section 5-337 


types(5) 


types(5) 


NAME 

types - primitive system data types 

SYNOPSIS 

include <sys/types.h> 

DESCRIPTION 

REMARKS 

The example given on this page is a typical version. The type names are in general expected to be present, 
although exceptions (if any) may be described in dependencies. In most cases the fundamental type 
which implements each typedef is implementation dependent as long as source code which uses those 
typedefs need not be changed. I n some cases the typedef is actually a shorthand for a commonly used type, 
and will not vary. 

The data types defined in the include file are used in hp-ux system code; some data of these types are 
accessible to user code: 


typedef 

struct { 

int r[1]; 

} *physadr 

typedef 

long 


daddr_t; 

typedef 

char 


* caddr_t 

typedef 

unsigned 

int 

uint; 

typedef 

unsigned 

short 

ushort; 

typedef ushort 


ino_t; 

typedef 

short 


cnt_t; 

typedef 

long 


time_t ; 

typedef 

long 


devt; 

typedef 

long 


off_t; 

typedef 

long 


paddr_t; 

typedef 

long 


key_t; 

typedef 

short 


pid_t; 

typedef 

long 


uid_t; 

typedef 

long 


gid_t; 


Note that the defined names above are standardized, but the actual type to which they are defined may 
vary between hp-ux implementations. 

The meanings of the types are: 

physadr used as a pointer to memory; the pointer is aligned to follow hardware-dependent 
instruction addressing conventions. 

daddr_t used for disk addresses except in an inode on disk, see fs(4). 

caddr_t used as an untyped pointer or a pointer to untyped memory, 

uint shorthand for unsigned integer, 

ushort shorthand for unsigned short, 

i no t used to specify I -numbers. 

cnt_t used in some implementations to hold reference counts for some kernel data structures, 

timet time encoded in seconds since00:00:00GMT, J anuary 1, 1970. 

da/_t specifies kind and unit number of a device, encoded in two parts known as major and 
minor. 

off_t offsets measured in bytes from the beginning of a fiIe. 

paddr_t used as an integer type which is properly sized to hold a pointer. 

keyt the type of a key used to obtain a message queue, semaphore, or shared memory 
identifier, seestdipc(3C). 

pid_t used to specify process and process group identifiers. 

uid_t used to specify user identifiers. 
gid_t user to specify group identifiers. 
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SEE ALSO 

fs(4), stdipc(3C). 

STANDARDS CONFORMANCE 

<sys/types .h >: AES, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1 
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NAME 

unctrl.h - definitions for unctrio 

DESCRIPTION 

The <unctrl. h> header defines the chtype type as defined in <curses . h> . 
The foil owing is declared as a function, and may also be defined as a macro: 

char *unctrl (chtype C) ; 

SEE ALSO 

curses. h>. 

CHANGE HISTORY 

First released in X/Open Curses, Issue4. 
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NAME 

unitsd: unistd.h - standard structures and symbolic constants 

SYNOPSIS 

#include <unistd.h> 


DESCRIPTION 

The header <unistd. h> defines the foil owing structures and symbolic constants: 

Symbolic constants for the access () function: 

R_OK Test for read permission. 

W OK Test for wri te permi ssi on. 

X_OK Test for execute (search) permission. 

F_OK Test for existence of file. 

The constants F_OK, R_OK, W_OK, and X_OK and the expressions R_OK|W_OK, R_OK|X_OK, and 
R_OK | W OK | X_OK all have distinct values. 

Symbolic constant representing a null pointer: 

NULL 


Symbolic constants for the lseek() and fcntl() functions (the following constants have distinct 
values): 


SEEK_J3ET Set file offset to "offset". 

SEEK CUR Set file offset to current plus "offset". 

SEEK_END Set file offset to EOF plus "offset". 

Symbolic constants (with fixed values): 

_P0SIX_VERSI0N Integer value indicating version of ieee Std 1003.1 standard implemented. 

The current value is 199009L, indicating the (4-digit) year and (2-digit) 
month that the standard was approved by the IEEE Standards Board. 
However, if any of the symbols _AES_SOURCE, _XPG3, or 
_POSlXl_1988 is defined before <unistd.h>is included, the value of 
this symbol will bel98808L. 

_P0SIX2_VERSI0N Integer value indicating version of IEEE Std 1003.2 standard implemented. 

The current value is 199209L, indicating the (4-digit) year and (2-digit) 
month that the standard was approved by the IEEE Standards Board. 

_P0SIX2_CJVERSI0N Integer value indicating version of ieee Stdl003.2 C-Language Binding 
Option implemented. The current value is 199209L, indicating the (4-digit) 
year and (2-digit) month that the standard was approved by the IEEE Stan¬ 
dards Board. 


XOPEN VERSION Integer value indicating issue number of the X/Open Portability Guide 
implemented. The current value is 4, indicating Issue 4. However, if the 
symbol _XPG3 is defined before <unistd.h> is included, the value of this 
symbol will be3. 

The following symbolic constants are defined in this header if the state of the corresponding option or res¬ 
triction does not vary after compilation. If a symbol is absent from this header, the value or presence of the 
corresponding option or restriction should be determined at execution time through sysconf () or path- 
conf (): 


POSIX_CHOWN_RESTRICTED 

The use of chown() is restricted to processes that have appropriate 
privileges. 

POSIX_JOB CONTROL 

Implementation supports job control (true of all HP-UX implementations). 
POSIX NO TRUNC Pathname components longer than NAME_MAX generate an error. 

POSIX_ REALTIME SIGNALS 

Implementation supports Realtime Signals Extensions (true of all HP-UX 
implementations). 
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_POSIX SAVED IDS Effective user and group are saved across an exec () call (true of all HP- 
UX implementations). 

POSIX FSYNC Implementation supports File Synchronization (true of all HP-UX imple¬ 

mentations). Seeopen(2). 

_POSIX_SYNCHRONIZED_IO 

Implementation supports Synchronized 10 (true of all HP-UX implementa¬ 
tions). Seeopen(2). 

POSIX VDISABLE Terminal special characters can be disabled using this character (see ter- 
mio(7)). 

POSIX THREADS I mplementation supports POSIX threads. 

_P0SIX2_C„BIND All POSIX.2 C-language functionality is provided in the default libraries 
used by the c89 C compiler (seecc(l)). 

_P0SIX2 LOCALEDEF New locales can be defined by using the localedef command (see 
localedef(lM)). 

_P0SIX2_UPE The system supports IEEE Stdl003.2a (POSIX User Portability Utilities 

Option). 

P0SIX2 CHAR TERM At least one terminal exists that supports all required POSIX.2a com¬ 
mands. 

All symbolic constants whose names begin _CS, _PC, and _SC (see confstr(3C), pathconf(2), and sys- 

conf(2)) are defined. 

The foil owing symbolic constants for file streams are defined: 

STDIN_FILEN0 Filenumber of standard input (stdin). 

STD0UT_FILEN0 Filenumber of standard output (stdout). 

STDERR_FILEN0 Filenumber of standard error (stderr). 

The types size_t, ssize_t, uid_t, gid_t, off_t, and pid_t are defined. 

Declarations are provided for thefollowing functions: 


access () 

alarm() 

brk () 

chdir() 

chown() 

chroot() 

close () 

confstr () 

crypt() 

ctermid() 

cuserid() 

dup() 

dup2() 

encrypt() 

endusershell() 

execl () 

execle() 

execlp() 

execv() 

execve() 

execvp() 

_exit() 

fchown() 

fork () 

fpathconf() 

f sync () 

ftruncate() 

getcwd() 

getegid() 

geteuid() 

getgid() 

getgroups() 

gethostname() 

getlogin() 

get opt () 


getpass() 

getpgrp() 

getpgrp2() 

getpid() 

getppid() 

getuid() 

getusershell() 

initgroups() 

ioctl () 

isatty () 

link() 

lockf () 

logname() 

lseek() 

mkstemp() 

mktemp() 

nice () 

pathconf () 

pause() 

pipe() 

prealloc() 

read() 

readlink() 

rmdir() 

sbrk() 

setgid() 

setgroups() 

sethostname() 

setpgid() 

setpgrp() 

setpgrp2() 

setresgid() 

setresuid() 

setsid() 

setuid() 

setusershell() 

sgetl() 

sleep() 

sputl () 

swab() 

swapon() 

symlink() 

sync () 

sysconf() 

tcgetpgrp () 

tcsetpgrp() 

truncate() 

ttyname() 

ttyslot () 

unlink() 

vfork() 

write() 


SEE ALSO 

access(2), chown(2), confstr(3C), exit(2), fcntl (2), ki 11 (2), lseek(2), open(2), pathconf(2), sysconf(2), limits(5), 
stdsyms(5), termio(7). 
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AUTHOR 

unistd was developed by HP. 

STANDARDS CONFORMANCE 

<unistd.h>: AES, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, POSIX.2, POSIX.4 


HP-UX Release 11.0: October 1997 


3- 


Section 5-343 


values(5) 


values(5) 


NAME 

values - machine-dependent values 

SYNOPSIS 

include <values.h> 

DESCRIPTION 

This file contains a set of manifest constants, conditionally defined for particular processor architectures. 

The model assumed for integers is binary representation (one's or two's complement), where the sign is 
represented by the value of the high-order bit. 

BiTS(type) The number of bits in a specified type (eg., int). 

hibits The valueof a short integer with only the high-order bit set (in most implementations, 

0x8000). 

hibitl The value of a long integer with only the high-order bit set (in most implementations, 

0x80000000). 

hibiti The value of a regular integer with only the high-order bit set (usually the same as 

HIBITS or HIBITL). 

maxshort The maximum value of a signed short integer (in most implementations, 0x7FFF = 
32767). 

maxlong The maximum value of a signed long integer (in most implementations, 0x7FFFFFFF 
= 2147483647). 

maxint The maximum value of a signed regular integer (usually the same as maxshort or 

MAXLONG). 

MAXFLOAT, LN_MAXFLOAT 

The maximum valueof a single-precision floating-point number, and its natural loga¬ 
rithm. 

MAXDOUBLE, LN_MAXDOUBLE 

The maximum valueof a double-precision floating-point number, and its natural loga¬ 
rithm. 

MINFLOAT, LN_M I N FLOAT 

The minimum positive value of a single-precision floating-point number, and its 
natural logarithm. 

MINDOUBLE, LN_MINDOUBLE 

The minimum positive value of a double-precision floating-point number, and its 
natural logarithm. 

fsignif The number of significant bits in the mantissa of a single-precision floating-point 

number. 

dsignif The number of significant bits in the mantissa of a double-precision floating-point 
number. 

FILES 

/usr/i ncl ude/val ues. h 

SEE ALSO 

intro(3), math(5). 

STANDARDS CONFORMANCE 

<values .h>: XPG2 
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NAME 

varargs - handlevariableargument list 

SYNOPSIS 

#include <varargs.h> 

va_alist 

va_dcl 

void va_start(pvar) 
va_list pvar; 

type va_arg (pvar, type) 
va_list pvar; 

void va_end(pvar) 
va_list pvar; 

DESCRIPTION 

This set of macros enables programmers to write portable procedures that accept variable argument lists. 
Routines that have variable argument lists (such as printf()) but do not use varargs are inherently 
nonportable, because different machines use different argument-passing conventions (see pri ntf(3S)). 

va_alist is used as the parameter list in a function header. 
va_dcl is a declaration for va_alist . No semicolon should follow va_dcl. 
va_list is a type defined for the variable used to traverse the list. 
va_start iscalledto initialize pvar to the beginning of thelist. 

va__arg returns the next argument in the list pointed to by pvar. type is the type the argument is 
expected to be. Different types can be mixed, but it is up to the routine to know what type of argument is 
expected, because it cannot be determined at runtime. 

va__end is used to clean up. 

Multipletraversals, each bracketed by va_start ... va_end, are possible. 

EXAMPLE 

The following example shows a possible implementation of execl() (see e<ec(2)): 

#include <varargs.h> 

#define MAXARGS 100 

/* execl is called by 

execl(file, argl, arg2, (char *)0); 

*/ 

execl(va_alist) 
va_dcl 
{ 

va_list ap; 
char *file; 
char *args[MAXARGS]; 
int argno = 0; 

va_start(ap); 

file = va_arg(ap, char *); 

while ((args[argno++] = va_arg(ap, char *)) != (char *)0); 

va_end(ap); 

return execv(file, args); 

} 

The next example illustrates how a function that receives variable arguments can pass these arguments 
down to other functions. To accomplish this, the first routine (log_errors () in this example) which 
receives the variable argument list must pass the address pointer resulting from a call to va_start () 
on to any subsequent calls that need to access this same variable argument list. All routines that receive 
this address pointer (v_print_log () in this example) need only to use va_arg () to access the origi¬ 
nal variableargument list just as if they were the original routine to be passed the variable arguments. 
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In this example, one can imagine that there are a series of other routines (such as a log_warning () 
and log_message ()) that also call the v_print_log () function. 

#include <stdio.h> 

#include <varargs.h> 

#include <unistd.h> 

int error_count; 

/* VARARGS4 — for lint */ 
int 

log_errors(log_fp, func_name, err_num, msg_fmt, va_alist) 

FILE *log_fp; 
char * func_name; 
int err_num; 
char *msg_fmt; 
va_dcl 
{ 


va_list ap; 

/* Print error header information */ 

(void) fprintf(Iog_fp, "\ nERROR in process %d\ n", getpidO); 
(void) fprintf(Iog_fp, " function \ "%s\", func_name); 
switch (err num) 

{ 

case ILLEGAL OPTION: 

(void) fprintf(log_fp, "illegal option\ n"); 
break: 

case CAN NOT PARSE: 

(void) fprintf(log_fp, "cannot parse input file\ n"); 
break; 


} 

/* 

* Get pointer to first variable argument so that we can 

* pass it on to v_print_log(). We do this so that 

* v_print_log() can access the variable arguments passed 

* to this routine. 

*/ 

va_start(ap); 

v_print_l o g(log_fp, msg_fmt, ap); 
va_end(ap); 


/* VARARGS2 -for lint*/ 
int 

v print log(log fp, fmt, ap) 
FILE *(og_fp; “ 
char *fmt; 



/* 

* If "%Y" is the first two characters in the format string, 

* a second file pointer has been passed in to print general 

* message information to. The rest of the format string is 

* a standard printf(3S) format string. 

*/ 
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if ((*fmt ='%') && (*(fmt +1) = Y')) 

{ 

FILE *other_fp; 
fmt += 2; 

other_fp = (FILE *) va arg(ap, char *); 
if (other_fp !=(FILE *)~NULL) 



* Print general message information to additional stream. 

*/ 

(void) vfprintf(other_fp, fmt, ap); 

(void) fFlush(other_fp); 

} } 

/* 

* Now print it to the log file. 

*/ 

(void) vfprintf(log_fp, fmt, ap); 


WARNINGS 

It is up to the calling routine to specify how many arguments there are, because it is not always possibleto 
determine this from the stack frame. For example, execl() is passed a zero pointer to signal the end of 
thelist. printf() can determine how many arguments are present by the format. 

It is non-portable to specify a second argument of char, short, or float to va__arg, because argu¬ 
ments seen by the called function are not char, short, or float. C converts char and short argu¬ 
ments to int, and converts float arguments to double, before passing them to a function. 

SEE ALSO 

exec(2), vprintf(3S). 

STANDARDS CONFORMANCE 

va_alist : AES, SVID2, SVID3, XPG2, XPG3, XPG4 

va_arg: SVID2, SVID3, XPG2, XPG3, XPG4 
va_dcl : SVI D2, SVI D3, XPG2, XPG3, XPG4 
va_end: SVI D2, SVI D3, XPG2, XPG3, XPG4 
va_list : SVI D2, SVI D3, XPG2, XPG3, XPG4 
va_start : SVI D2, SVI D3, XPG2, XPG3, XPG4 
<varargs .h> : AES, SVI D3, XPG2, XPG3, XPG4 
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NAME 

x_open - pointer manual entry for X/Open Conformance Statement Questionnaire 

DESCRIPTION 

This entry is a pointer entry for accessing the X/Open Conformance Statement Questionnaire for HP 9000 
Series 700/800 H P-ux systems. To access the conformance statement, use the command: 

man x_open_800 

FILES 

/u sr/sh a r e/ma n/ma n 5. Z/x_open_800.5 

Series 700/800 X/Open Conformance Statement Questionnaire (preformatted and compressed) 
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NAME 

intro - introduction to device special files 

DESCRIPTION 

This section describes the device special files used to access HP peripherals and device drivers. The names 
of the entries are generally derived from the type of device being described (disk, terminal, etc.), not the 
names of the device special files or device drivers themselves. Characteristics of both the hardware device 
and the corresponding hp-ux device driver are discussed where applicable. 

The devices can be classified in two categories, raw and block. A raw or character-mode device, such as a 
line printer, transfers data in an unbuffered stream and uses a character device special file. 

Block devices, as the name implies, transfer data in blocks by means of the system's normal buffering 
mechanism. Block devices use block device special files and may have a character device interface too. 

A device special file name becomes associated with a device when the file is created, using the mksf(lM), 
insf(lM), or mknod(lM) commands. When creating device special files, it is recommended that thefollow- 
ing standard naming convention be used: 

/dev/ prefix/devspec[options] 

prefix indicates the subdirectory for the device class (for example, rdsk for raw device special files for 
disks, dsk for block device special files for disks, rmt for raw tape devices). 

devspec indicates hardware path information and is typically in the format c#t#d#as follows: 

c# I nstance number assigned by the operating system to the interface card. There is no 
direct correlation between instance number and physical slot number. 

t# Target address on a remote bus (for example, SCSI or HP-1 B address), 

d# Device unit number at the target address (for example, SCSI LUN). 

options Further qualifiers, such as disk section s#(for backward compatibility), tape density selection for 
a tape device, or surface specification for magneto-optical media. 

Hardware path information can be derived from ioscan(lM) output. 

EXAMPLES 

The foil owing is an example of a disk device special file name: 

/dev/dsk/c0t6d0 

where dsk indicates block disk access and c0t6d0 indicates disk access at interface card instanceO, tar¬ 
get address 6, and unit 0. Absence of syndicates access to the entire disk (see disk(7) for details). 

The foil owing is an example of a tape device special file name: 

/dev/rmt/c2t3d0QIC150 

where rmt indicates raw magnetic tape, c2 indicates that the device is connected to interface card 
instance 2, t3 indicates that target device address is set to 3, dO indicates that the tape transport resides 
at unit address 0, and QIC150 identifies the tape format as QIC 150 (see mt(7) for details). 

WARNINGS 

In the past, other naming conventions have been used for device special files. Using In(1) to create a link 
between the old and new standard name is useful as a temporary expedient until all programs using an old 
naming convention have been converted. 

SEE ALSO 

hier(5), ioscan(lM), mksf(lM), insf(lM), Issf(lM). 

The system administrator manual for your system. 


HP-UX Release 11.0: October 1997 


-1- 


Section 7-1 


arp(7P) 


arp(7P) 


NAME 

arp - Address Resolution Protocol 

DESCRIPTION 

arp is a protocol used to dynamically map between darpa Internet and hardware station addresses. It is 
used by all LAN drivers. 

arp caches I nternet-to-hardware station address mappings. When an interface requests a mapping for an 
address not in the cache, arp queues the message that requires the mapping, and broadcasts a message on 
the associated network requesting the address mapping if the ether encapsulation method has been 
enabled for the interface. If a response is provided, the new mapping is cached and any pending message is 
transmitted, arp queues at most one packet while waiting for a mapping request to be responded to; only 
the most recently "transmitted" packet is kept. 

To facilitate communications with systems that do not use arp, ioctl calls are provided to enter and 
delete entries in the I nternet-to-hardware station address tables. 


Application Usage: 

#include <sys/ioctl.h> 
#include <sys/socket.h> 
#include <net/if.h> 

#include <netinet/if_ether.h> 
struct arpreq arpreq; 


ioctl(s, SIOCSARP, (caddr_t)&arpreq); 
ioctl(s, SIOCGARP, (caddr_t)&arpreq); 
ioctl(s, SIOCDARP, (caddr_t)&arpreq); 

Each ioctl call takes the same structure as an argument. SIOCSARP sets an arp entry, SIOCGARP 
gets an arp entry, and SIOCDARP deletes an arp entry. These ioctl calls can be applied to any socket 
descriptor s, but only by the super-user. The arpreq structure contains: 


/* 

* ARP ioctl request 
*/ 

struct arpreq { 

int32_t ifindex; 
int32_t arp_flags; 
int32_t arp_hw_addr_len; 
struct sockaddr arp__pa; 
struct sockaddr arp_ha; 
u_char arp_pad[242]; 

} ; 

/* arp__flags field values */ 


#define ATF_.COM 0x02 

#define ATF_PERM 0x04 

#define ATF_PUBL 0x08 

#define ATF_SNAPFDDI 0x200 

#define ATF_SNAP8025 0x400 

#define ATF_IEEE8025 0x800 

#define ATF_FCSNAP 0x4000 


/* flags */ 

/* hardware address length */ 

/* protocol address */ 

/* hardware address */ 

/* buffer for link specific info. */ 


/* ARP on ether */ 

/* permanent entry */ 

/* publish entry */ 

/* SNAP - FDDI */ 

/* SNAP - 8025 */ 

/* IEEE - 8025 */ 

/* Fibre Channel SNAP */ 


The address family for the arp pa sockaddr must be AF_INET; for the arp ha sockaddr it must be 
AFUNSPEC . The only flag bits that can be written are ATF_PERM, and ATF_PUBL. Fibre Channel 
hosts only support the ATF_PERM flag. ATF_PERM causes the entry to be permanent. ATF_PUBL 
specifies that the arp code should respond to arp requests for the indicated host coming from other 
machines. This allows a host to act as an arp server, which may be useful in convincing an ARP-only 
machineto talk to a non-ARP machine. 


arp watches passively for hosts impersonating the local host (i.e., a host that responds to an arp mapping 
request for the local host's address). 


DIAGNOSTICS 

duplicate IP address!! sent from ethernet address: %x:%x:%x:%x:%x:%x. 

This message printed on the console screen means that arp has discovered another host on the local 
network that responds to mapping requests for its own I nternet address. 
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WARNINGS 

To enable the ether encapsulation method, use the ifconfig command (see ifconfig(lM)). 

AUTHOR 

arp was developed by the University of California, Berkeley. 

SEE ALSO 

ifconfig(lM), inet(3N), lan(7), arp(lM). 

An Ethernet Address Resolution Protocol, RFC826, Dave Plummer, Network Information Center, SRI. 
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NAME 

autochanger - SCSI interfaces for medium changer device and magneto-optical autochanger surface device 

DESCRIPTION 

An autochanger is a SCSI mass storage device, consisting of a mechanical changer device, one or more data 
transfer devices (such as optical disk drives), and media (such as optical disks) for data storage. The 
mechanical changer moves media between storage and usage locations within the autochanger. 

Depending on system architecture, one of two medium changer drivers (schgr or autoxO) provides 
access to the medium changer device; a module (ssrfc) provides access to the surfaces of the optical 
disks. 

Two levels of functionality are provided by the medium changer drivers. The mechanical changer device 
can be accessed directly to move media within the autochanger. Alternatively, media surfaces can be 
accessed as unique devices, causing the changer driver to move the media into a drive to perform an I/O 
request. 

The schgr and autoxO medium changer device drivers follow thescsi specification for medium changer 
devices to provide a generic medium changer interface, making it feasibleto construct an application level 
driver for any mechanical changer, jukebox, library, or autochanger device (MO, tape, CD-ROM). 

However, the ssrfc module is provided specifically to support Hewlett-Packard magneto-optical disk 
autochanger products. 

Device Naming Convention 

The device naming convention for the autochanger driver enables accessing the changer device, as well as 
individual media surfaces. Block devices for autochangers reside in /dev/ac, character devices reside in 
/dev/rac. Within these directories, names are derived from the "c#:#)#' device naming convention 
(explained in intro(7)), with the surface descriptor appended at the end. U nique device names are deter¬ 
mined by the card instance, target address of the SCSI changer device, LUN of the SCSI changer device, 
and the surface descriptor. 

The surface descriptor can be zero or non-specified for the changer device. Also, there is no block special 
file for the changer itself. For example, 

/dev/rac/clt5d0 

is the character special file for the changer at SCSI target address 5 and LUN 0, attached to SCSI card 
instance 1, and is equivalent to /dev/rac/clt5d0_0. 

Any given surface is described by the card instance, SCSI target address and SCSI LUN of the changer, 
and then appended with a surface descriptor for the slot number and side. For example, 

/dev/ac/clt5d0_la 

is the block special file for surface la of the autochanger just mentioned and 
/dev/rac/clt5d0_la 
is the character special file for the same surface la. 

Major and Minor Number Descriptions 

The foil owing shows the bit assignments (dev_t format) used by the changer drivers to access the changer 
device and each surface within an autochanger: 


0-7 

8-15 

16-19 

20-22 

23-31 

MAJ OR 

INSTANCE 

TARGET 

LUN 

SURFACE 


MAJ OR is the major number of the appropriate driver, INSTANCE is the card instance of the SCSI inter¬ 
face to which the changer device is attached, TARGET is the SCSI target address of the changer device, 
LUN is the SCSI LUN of the changer device, and SU RFACE is the unique descriptor of each surface in the 
autochanger, as described in thefollowingtable. (Note, the surface descriptors refer to bits 23-31.) 
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Surface 

Surface Descriptor 

changer device 

0 

la 

01 

lb 

02 

2a 

03 

2b... 

04... 

31b 

3e 

32a 

3f 

32b.... 

40.... 


All fields in the device number are specified in hexadecimal notation. Note that there is no support for 
hard partitions (sections) in this minor number. If desired, partitioning can be achieved via LVM soft- 
partitioning schemes. 

The major numbers used by the changer drivers are: 



b major 

c major 

schgr 

29 

231 

autoxO 

30 

230 


Following are long listings showing the major and minor numbers associated with the device special file 
names of the first surface and the changer: 


schgr: 

brw-rw-rw- 

i 

root 

sys 

29 

0x015001 

Apr 

22 

10:22 

/dev/ac/clt5d0_la 

crw-rw-rw- 

i 

root 

sys 

231 

0x015001 

Apr 

22 

10:22 

/dev/rac/clt5d0_la 

crw-rw-rw- 

i 

root 

sys 

231 

0x015000 

Apr 

22 

10:22 

/dev/rac/clt5d0 

autoxO: 

brw-rw-rw- 

i 

root 

sys 

30 

0x015001 

Apr 

24 

11:35 

/dev/ac/clt5d0_la 

crw-rw-rw- 

i 

root 

sys 

230 

0x015001 

Apr 

24 

11:35 

/dev/rac/clt5d0_la 

crw-rw-rw- 

i 

root 

sys 

230 

0x015000 

Apr 

24 

11:35 

/dev/rac/clt5d0 


MAGNETO-OPTICAL AUTOCHANGER SURFACE DEVICE ACCESS 

To access disk surfaces within H P magneto-optical libraries, it is necessary to include the entry for the sur¬ 
face module, ssrfc, in the system configuration file /stand/system, as well as an entry for the 
appropriate SCSI changer driver, schgr or autoxO, depending on architecture. The ssrfc module 
enables accessing a magneto-optical disk surface much like a disk device. The disk is moved into an idle 
drive by the changer, then the requested disk I/O operation is performed. Upon completion of the request, 
the disk is returned to its storage location within the autochanger. 

The surface module allows concurrent access to as many disks as there are drives in the autochanger pro¬ 
duct. Requests for I/O on additional disks within the autochanger are blocked awaiting an availabledrive 
resource. 

By default, some commands (such as mount, newfs, and mediainit) open the device with the 
0_NDELAY flag set. Invocations of these commands on an autochanger surface do not wait for a drive 
resource to become available. I nstead, these requests return with EBUSY if no drive is available. 

Developers using the surface module functionality to access autochanger disks can invoke the open system 
call with the 0_NDELAY flag to achieve this same "non-blocking" behavior: 

error = open("/dev/rac/clt5d0_la" ,0_RDWR | 0_NDELAY); 

If it is acceptableto block waiting for an availabledrive resource, the 0_NDELAY flag is unnecessary. 

Flere is a sample script to access multiple disk surfaces in an autochanger that has 2 drives, minimizing 
blocking: 

dd if=/dev/rdsk/cOtOdO of=/dev/rac/clt5d0_la bs=64k & 
dd if=/dev/rdsk/cOtldO of=/dev/rac/clt5d0_2a bs=64k & 
wait 

dd if=/dev/rdsk/c0t2d0 of=/dev/rac/clt5d0_lb bs=64k & 
dd if=/dev/rdsk/c0t3d0 of=/dev/rac/clt5d0_2b bs=64k & 
wait 
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For developers, the ioctl functions availablefor accessing magneto-optical disk surfaces are described in 
the manual pages for SCSI disk drivers. Several ioctl functions provided specifically for magneto-optical 
disks will be described here briefly. Included from <sys/scsi .h >: 


#define SIOC_WRITE WOE 
#define SIOC_VERIFY_WRITES 
#define SIOC_ERASE 
#define SIOC_VERIFY BLANK 
#define SIOCJVERIFY 


_IOW('S', 17, int) 

_IOW('S', 18, int) 

_IOW('S', 19, struct scsi_erase) 
_IOW('S', 20, struct scsiverify) 
__IOW('S', 21, struct scsi verify) 


SIOC_ERASE (erase) and SI OC_WRITE_WOE (write without erase) can be used together on character spe¬ 
cial devices. By performing a pre-erase pass of magneto-optical disks, then later setting the SCSI disk 
driver in write-without-erase mode, improved write performance can be achieved, eliminating the two-pass 
erase-then-write which is normally necessary on magneto-optical devices. 


SIOC VERI FYWRITES (write and verify) performs a verification pass on any writes to magneto-optical 
disks. This is a good safeguard for data integrity. Flowever, write operations performed with the 
verification pass exhibits a decrease in performance. When used with pre-erase and write-without-erase, 
write and verify provide increased reliability of data without decreased performance. HP recommends 
operating in write-and-verify mode if also performing write-without-erase. 


The following are additional ioctl functions that might be desirablefor some magneto-optical products, 
included from <sys/scsi .h>: 


#define SIOC„GET_IR 
#define SIOC_SET_IR 
#define SIOC_ SYNC CACHE 


_IOR('S', 14, int) 
_IOW('S', 15, int) 
_IOW('S', 70, int) 


SlOC_GET_lR determines the current state of immediate reporting (write caching) on the device. 
SlOC_SET_lR enables or disables immediate reporting on the device. If SI0C_SET_IR is used to 
enable write caching, it may be desirable to flush the write cache using the SlOC_SYNC_CACHE ioctl 
function. The command /usr/sbin/scsictl may be used to perform the pre-erase of magneto¬ 
optical disks, set and check the status of immediate reporting. 

With the surface module configured, several ioctl functions to get status and information from the changer 
device are also available. These are SlOC_ELEMENT_ADDRESSES, SIOC_ELEMENT_STATUS , and 
SlOC_lNQUlRY ; they are explained further in the following section on the changer driver. Functions 
that modify the state of the autochanger are not allowed when the surface module is configured into the 
kernel. 


SCSI MEDIUM CHANGER DEVICE DRIVER 

The SCSI medium changer device driver performs moves between different media locations within an auto¬ 
changer. Each potential media location has a specific element address and is one of the following element 
types: 


storage 
i mport/ export 


data transfer 


media transport 


A location to hold a unit of media not currently in use. Typically most media will 
be located in this type of element. 

A location for inserting and removing media from the device. Movement of a 
unit of media to this type of location is in effect an eject operation. Movement of 
a unit of media from this type of location is a load operation. 

A location for accessing media data. This is generally the location of a device 
that reads and/or writes data on the media being handled by the media changer 
device. Movement to this type of location is a physical-media-mount operation. 
Movement from this type of location is a physical-media-unmount operation. 

A location for media movement. Media is generally temporarily located in this 
type of element only during actual media movement. 


Changer Control Requests 

The following ioctl functions are included from <sys/chgrio . h >: 

# define CHGR SSRFC__IS_PRESENT I OR (' X' , 1, int) 

#define CHGRCLEARRESET _IO('X', 2) 
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CHGR_SSRFC_IS_PRESENT 

For developers. To determine if the surface module functionality (ssrfc) is currently configured in 
the kernel. 

CHGR_CLEAR_RESET 

For developers. autoxO driver only. To clear a powerfail recovery condition in the SCSI changer 
driver. The CHGR_CLEAR_RESET ioctl function will be necessary for developers using the SCSI 
changer driver (autoxO) to move media within the medium changer, but not using the surface module 
for transparent access to magneto-optical disks. In the event of an econnreset error return from 
any changer ioctl call, a CHGR_CLEAR_RESET call will be necessary prior to any further media 
moves. This alerts the application of a possible power failure, and allows the developer an opportunity 
to reset data structures, and re-reserve elements in the medium changer, prior to further operations. 

The following ioctl functions and structure definitions are included from <sys/scsi .h >: 

#define SIOC_INIT_ELEM_STAT _IO('S', 51) 

#define SIOC_ELEMENT_ADDRESSES _IOW('S', 52, struct element_addresses) 

#define SIOC_ELEMENT_STATUS _IOWR('S', 53, struct element_status) 

#define SIOC_RESERVE _IOW('S', 54, struct reservation_parms) 

#define SIOC_RELEASE _IOW('S', 55, struct reservation_parms) 

#define SIOC_MOVE_MEDIUM _IOW('S', 56, struct move_medium_parms) 

#define SIOC_EXCHANGE_MEDIUM _IOW('S', 57, struct exchange_medium_parms) 

/* structure for SIOC_ELEMENT_ADDRESSES ioctl */ 
struct element_addresses { 

unsigned short first_transport; 
unsigned short num_transports; 
unsigned short first_storage; 
unsigned short num_storages; 
unsigned short first_import_export; 
unsigned short num_import_exports; 
unsigned short first_data_transfer; 
unsigned short num_data_transfers; 

}; 

/* structure for SIOC_ELEMENT_STATUS ioctl */ 
struct element_status { 

unsigned short element; /* element address */ 

unsigned int resvl:2; 

unsigned int import_enable:1; /* allows media insertion (load) */ 
unsigned int export_enable:1; /* allows media removal (eject) */ 
unsigned int access:1; /* transport element accessible */ 

unsigned int except:1; /* is in an abnormal state */ 

unsigned int operatril; /* medium positioned by operator */ 

unsigned int full:l; /* holds a a unit of media */ 

unsigned char resv2; 

unsigned char sense_code; /* info, about abnormal state */ 

unsigned char sense_qualifier; /* info, about abnormal state */ 

unsigned int not_bus:l; /* transfer device SCSI bus differs */ 

unsigned int resv3:l; 

unsigned int id_valid:l; /* bus_address is valid */ 

unsigned int lu_valid:l; /* lun is valid */ 

unsigned int sublu_valid:1; /* sub_lun is valid */ 

unsigned int lun:3; /* transfer device SCSI LUN */ 

unsigned char bus_address; /* transfer device SCSI address */ 

unsigned char sub_lun; /* sub-logical unit number */ 

unsigned int source_valid:1; /* source_element is valid */ 

unsigned int invert:1; /* media in element was inverted */ 

unsigned int resv4:6; 
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unsigned short source element; 
char pri_vol tag[36]; 
char alt_vol tag[36]; 
unsigned char misc bytes[168]; 


/* last storage medium location */ 
/* volume tag (device optional) */ 

/* volume tag (device optional) */ 

/* device specific */ 


/* structure for SIOC_RESERVE and SIOC_RELEASE ioctls */ 
struct reservationjarms ( 

unsigned short element; 
unsigned char identification; 
unsigned char all_elements; 

}; 


/* structure for SIOC MOVE MEDIUM ioctl */ 
struct move mediumjarms ( 

unsigned short transport; 
unsigned short source; 
unsigned short destination; 
unsigned char invert; 


/* structure for SIOC_EXCHANGE_MEDIUM ioctl 
struct exchange mediuitLparms ( 

unsigned short transport; 
unsigned short 
unsigned short 
unsigned short 
unsigned char 
unsigned char 

); 


source; 

first_destination; 
second destination; 
invert first; 
invert second; 


*/ 


SIOC INITELEM STAT 

Cause the media changer device to take inventory. As a result, the media changer device determines 
the status of each and every element address, including the presence or absence of a unit of media. 
This is a mechanical operation which can take time. This function only necessary in the event of a 
severe error of the media changer. If using the surface module (ssrfc) to move disks, this level of error 
recovery is handled within the surface module. 


SIOC_ELEMENT_ADDRESSES 

Determine the element addresses supported by a media changer device. The first valid element 
address and the number of elements is indicated for each element type. These element addresses may 
be used as source and destination location arguments. 


SIOC_ELEMENT_S TATUS 

Determine the status of an element. The element address for which status information is requested is 
specified via the element field. The resulting status data indicates the presence or absence of a 
unit of media in that element address as well as other information about the element address. 


SIOCRESERVE and SIOCRELEASE 

Control access to element addresses. Depending on the device, reservations may limit operator con¬ 
trol of those element addresses in the media changer device. Specific element addresses can be 
reserved to handle interlocking between multiple requesters if each requester has a unique reserva¬ 
tion identification. The value zero in the all_elements field specifies that a single element 
address should be reserved or released. An element address reserved in this manner can not be 
reserved by another single element address reservation using a different reservation identification. 
The reservation field specifies the reservation identification. The element field specifies the 
element address to be reserved. 


The value "1" in the all_elements field indicates that all element addresses should be reserved. 
The reservation and element fields should contain the value zero since these fields are not 
meaningful when reserving all element addresses. Reserving all element addresses is primarily useful 
for limiting operator control. 

SIOC MOVE MEDIUM and SIOC EXCHANGE MEDIUM 

Reposition unit(s) of media. Depending on the source and destination element types, this may result 
in a media load, eject, or simple repositioning. Media can be "flipped" using values of "1" in the 
invert, invert_first , or invert_second fields. The SIOC_EXCHANGE_MEDIUM ioctl 
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repositions two different units of media. One unit of media is moved from the element specified by the 
source field to the element specified by the first_destination field. A second unit of media 
is moved from the element specified by the f irst_destination field to the element specified by 
the second_destination field. In an autochanger with multiple changer mechanisms, or a 
media staging area, an exchange occurs if the source and second_destination fields are the 
same. 

DEPENDENCIES 

To obtain access to disk surfaces within HP magneto-optical libraries, the ssrfc module must be specified in 
the system configuration file. The ssrfc module depends on either the schgr driver, or the autoxO driver. If 
ssrfc is to be included, then one or both of schgr or autoxO must also be included. 

DEFAULT CONFIGURATIONS 

By default, ssrfc, schgr, and autoxO are not included in the system configuration 
(/stand/system) file. 

EXAMPLES 

The following example uses the SlOC_ELEMENT_ADDRESSES and SlOC_ELEMENT_STATUS ioctl 
functions to get bus address information about the drives in an HP magneto-optical autochanger: 

int last_drive_el; 

struct element_addresses el_addrs; 

struct element_status el_stat; 

/* 

* Changer attached to card instance 1, with SCSI target id 5, lun 0. 

*/ 

fd = open("/dev/rac/clt5d0",O RDWR); 

if ((error = ioctl(fd, SIOCELEMENTADDRESSES, Sel_addrs)) != 0) { 

syserr("ioctl: SIOCELEMENTADDRESSES"); 
return —1; 

} else { 

last_drive_el = el_addrs.first_data_transfer 

+ el_addrs.num_data_transfers - 1; 
for (i = el_addrs.first_data_transfer; i <= last_drive_el; i++) { 

el_stat.element = i; 

if ((error = ioctl(fd, SIOC_ELEMENT_STATUS, &el_stat)) != 0) { 

syserr("ioctl: SIOC_ELEMENT_ADDRESSES"); 
return -1; 

} else { 

/* 

* You may wish to also check some of the other fields 

* in the el_stat structure to verify that the data is 

* valid. Fields: el_stat.access (ac accessible), 

* el_stat.except (exception). 

*/ 

if (! el_stat.notbus && el stat.id valid) { 
drive[i].addr = el stat.bus address; 
if (! el stat.lu_valid) { 
drive[i].lun = 0; 

) else { 

drive[i].lun = el_stat.lun; 

) 

) 

) 

) 

) 

WARNINGS 

Do not use LVM to configure multiple autochanger surfaces as one large file system. LVM was designed for 
on-line volumes. I n an autochanger, only the disks actualy in the drives are on-line, whilethe disks stored 
in their slots are off-line. If LVM is not carefully configured, thrashing of the autochanger disks result in 
undesirablel/O performance. Plan carefully for best performance. 
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Some non-HP media changer devices do not support the SI0C_INIT_ELEM_STAT and 
SIOC_ELEMENT_STATUSioctls. 

Some older media changer devices do not support the SI0C_EXCHANGE_MEDIUM ioctl. For these 
devices, multiple SI0C_M0VE_MEDIUM ioctl operations may be used to accomplish thesame results, pro¬ 
vided a suitabletemporary element address may be found. 

SEE ALSO 

insf(lM), mknod(lM), scsictl(lM), ioctl(2), scsi(7), scsi_ctl(7). 
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NAME 

blmode - terminal block mode interface 

DESCRIPTION 

Thisterminal interface adds functionality to the current termio(7) functionality to allow for efficient emula¬ 
tion of mpe terminal driver functionality. Most importantly, it adds the necessary functionality to support 
block mode transfers with HP terminals. The block mode interface only affects input processing and does 
not affect write requests. Write requests are always processed as described in termio(7). In character 
mode the terminal sends each character to the system as it is typed. However, in block mode data is 
buffered and possibly edited locally in the terminal memory as it is typed, then sent as a block of data when 
the Enter key is pressed on the terminal. During block mode data transmissions, the incoming data is not 
echoed and no special character processing is performed, other than recognizing a data block terminator 
character. For subsequent character mode transmissions, the existing termio state continues to determine 
echo and character processing. 

There are two parts of the block mode protocol. The first part is the block mode handshake, which works 
as follows: 

• At the beginning of a read, a trigger character is sent to the terminal to notify it that the system is 
requesting a block of data. (The trigger character, if defined, is sent at the beginning of all reads, 
whether character or block. The trigger character must be defined for block mode reads.) 

• After receiving the trigger character, the terminal waits until the user has typed data into the 
terminal's memory and pressed the terminal Enter key. The terminal then sends an alert charac¬ 
ter to the system to notify it that the terminal has a block of data to send. 

• The system may then send user-definable cursor positioning or other data sequences to the termi¬ 
nal. When that is done, the system sends another trigger character to the terminal, repeating the 
cycle. 

The second part of the block mode protocol is the block mode transmission. During this transmission of 
data, the incoming data is not echoed and no special character processing is performed, other than recog¬ 
nizing the data block termination character. It is possible to bypass the block mode handshake and have 
the block mode transmission occur after the first trigger character is sent. 

To prevent data loss, xon/xoff flow control should be used between the system and the terminal. The 
ixoff bit should be set and the terminal strapped appropriately. If flow control is not used, it is possible 
for incoming data to overflow and be lost. (Note: some older terminals do not deal correctly with this flow 
control.) 

It is possibleto intermix both character mode and block mode data transmissions. If block mode transmis¬ 
sions are enabled, all transfers are handled as block mode transfers. When block mode transmissions are 
not enabled, character mode transmissions are processed as described in termio(7). If block mode transmis¬ 
sions are not enabled, but an alert character is received anywhere in the input data, thetransmission mode 
is switched to block mode automatically for a singletransmission. 

Read requests that receive data from block mode transmissions will not be returned until thetransmission 
is complete: i.e., the terminal has transmitted all characters. If the read is satisfied by byte count or if a 
data transmission error occurs, any subsequent data will be discarded. The read waits until completion of 
the data transmission before returning. 

The data block terminator character is included in the data returned to the user, and is included in the byte 
count. If the number of bytes transferred by the terminal in a block mode transfer exceeds the number of 
bytes requested by the user, the read returns the requested number of bytes, and the remaining bytes are 
discarded. The user can determine if data was discarded by checking the last character of the returned 
data. If thelast character is not the terminator character, more data was received than was requested, and 
data was discarded. 

If desired, the application program can provide its own handshake mechanism in response to the alert char¬ 
acter by selecting theOWNTERM mode. With this mode selected, the driver completes a read request when 
the alert character is received. The second trigger is sent by the driver when the application issues the 
next read. 

Several special characters (both input and output) are used with block mode. These characters and the nor¬ 
mal values used for block mode are described below. The initial valuefor these characters is 0377, which 
causes them to be disabled. 
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cbtrigic (DCi) is the initial trigger character sent to the terminal at the beginning of a read 
request. 

CBTRIG2C (DCi) is the secondary trigger character sent to the terminal after the alert character 
has been received. 


cbalertc (DC2) is the alert character sent by the terminal in response to the first trigger charac¬ 
ter. It signifies that the terminal is ready to send the data block. The alert character 
can be escaped by preceding it with a backslash (\ ). 

cbtermc (RS) is sent by the terminal after the block mode transfer is complete. It signifies the 
end of the data block to the computer. 

The two ioctl (2) requests that apply to block mode use the blmodeio structure, which defined in 
<blmodeio .h>, and includes thefollowing members: 


unsigned long 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
char 


cb_flags; 

cb_triglc; 

cb_trig2c; 

cb_alertc; 

cb_termc; 

cb_replen; 

cb_reply[ ]; 


/* M odes */ 

/* First trigger */ 

/* Second trigger */ 

/* Alert character */ 

/* Terminating char */ 
/* cb_reply length */ 

/* optional reply */ 


The cb_flags member controls the basic block mode protocol: 


cb bmtrans 0000001 Enable mandatory block mode transmission. 

cb OWNTERM 0000002 Enable user control of handshake. 


The cb_bmtrans bit is only effective when the icanon flag in termio(7) is set. If icanon is clear, all 
transfers are done in raw mode, regardless of the cb bmtrans bit. If cb bmtrans is not set, input 
processing is performed as described in termio(7). During this time, if the alert character is defined 
and is detected anywhere in the input stream, the input buffer is flushed and block-mode handshake is 
invoked. The system then sends the cb_trig2c character to the terminal, and a block mode transfer 
follows. Thealert character can be escaped by preceding it with a backslash (\ ). 

If cb bmtrans is set, then all transmissions are processed as block mode transmissions. Block mode 
handshake is not required and data read is processed as block mode transfer data. Block mode 
handshake can still be invoked by receipt of an alert character as the first character received. Reads 
issued whiletheCBBMTRANS bit is set cause any existing input buffer data to be flushed. 

If cb ownterm is set, reads are terminated upon receipt of a non-escaped alert character. No input 
buffer flushing is performed and thealert character is returned in the data read. This allows applica¬ 
tion code to perform its own block-mode handshaking. If the bit is clear, an alert character causes 
normal block mode handshaking to be used. 

The initial cb_flags value is all-bits-cleared. 

The cb_triglc character is the initial trigger character sent to the terminal at the beginning of a read 
request. The initial value is undefined (0377); i.e., no trigger character is sent. 

The cb_trig2c character is the secondary trigger character sent to the terminal after the alert character 
has been received. The initial value is undefined (0377). 


The cb_alertc character is the alert character sent by the terminal in response to the first trigger char¬ 
acter sent by the computer. It signifies that the terminal is ready to transmit data. The initial value is 
undefined (0377). 


The cb_termc character is sent by the terminal after the block mode transfer has completed. It signifies 
the end of the data block to the computer. The initial value is undefined (0377). 

The cb_replen member specifies the length in bytes of the cb_reply array. The maximum length of 
thecb_reply array is NBREPLY bytes. If set to zero, the cbreply string is not used. It isinitially set to 
zero. 


The cb_reply array contains a string to be sent out after receipt of the alert character but before the second 
trigger character is sent by the computer. Any character can be included in the reply string. The number 
of characters sent is specified by cb_replen. The maximum length of the cb_reply array is NBRE¬ 
PLY bytes. The initial value of all characters in the cb_reply array is null. 
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On systems that support process group control, ioctl requests are restricted from use by background 
processes, unless otherwise noted for a specific request. An attempt to issue an ioctl request from a back¬ 
ground process causes the process to block and may cause a SIGTTOU signal to be sent to the process group. 

The primary ioctl (2) calls have the form: 

int ioctl(int fildes, int request, struct blmodeio *arg); 

Requests using this form include: 

CBGETA Get the parameters associated with the block mode interface and store them in the 

blmodeio structure referenced by arg. This request is allowed from a background pro¬ 
cess. However, the information may be subsequently changed by a foreground pro¬ 
cess. 

CBSETA Set the parameters associated with the block mode interface from the blmodeio struc¬ 

ture referenced by arg. The change is immediate. 

RETURN VALUE 

Refer to read(2), write(2), and ioctl (2). 

ERRORS 

If an error value is returned during a read, it is possiblefor the user's buffer to be altered. I n this case, the 
data in the user's buffer should be ignored because it is incomplete. 

The global variable errno will be set to indicate the following error, in addition to those errors described on 
read(2), write(2), and ioctl (2): 

[Eio] A read error occurred duringthetransmission of the block mode data block. 

WARNINGS 

The eio error that is returned for read errors can be caused by many events. The read returns eio for 
transmission, framing, parity, break, and overrun errors, or if the internal timer expires. The internal 
timer starts when the second trigger character is sent by the computer, and ends when the terminating 
character is received by the computer. The length of this timer is determined by the number of bytes 
requested in the read and the current baud rate, plus an additional ten seconds. 

AUTHOR 

The blmodedriver was developed by HP. 

SEE ALSO 

termio(7). 
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NAME 

cent - Centronics-compatible interface 

DESCRIPTION 

cent is a simple, widely used communication protocol most commonly associated with printers, plotters 
and scanners. It is an eight-bit parallel data interface with additional control signals from the host com¬ 
puter, and status signalsfrom the peripheral. 

The cent interface driver does no character processing; that is, it does not interpret the data being 
transferred between computer and peripheral. Therefore, all bytes sent to or received from a device are 
handled without alteration. The cent interface driver always operates in raw mode; therefore, any 
desired data interpretation must be performed by a user program (such as the "Ip" spooler in conjunction 
with an appropriate model file). The cent driver supports six different handshake modes for data 
transfer. The last four bits of the minor number of the device special file specify the mode used. The for¬ 
mat of the device minor number is: 

Oxl 1000A 

where each letter after the "Ox" prefix represents a single hexadecimal digit, as follows: 

II Specifies the instance number of the centronic interface. 

000 Always zero. 

A Specifies the handshake mode. The handshake modes are: 

mode 1 Automatic handshaking using both ack and busy. 

Minor number format: Oxl 10001. 

mode 2 Automatic handshaking using only busy. 

Minor number format: 0x110002. 

mode 3 Bidirectional read/write used for ScanJ et. 

Minor number format: 0x110003. 

mode4 Stream mode. Data is essentially transmitted to the peripheral without any 
handshaki ng protocol. 

Minor number format: 0x110004. 

mode 5 Pulsed mode using both ack and busy for automatic handshaking. Similar to mode 1 
except that the data strobe line, n strobe is pulsed for a fixed amount of time by the 
sender, then released. 

Minor number format: 0x110005. 

mode 6 Pulsed mode, using only busy for automatic handshaking. Similar to mode 1 except 
that the data strobe line, n strobe is pulsed for a fixed amount of time by thesender, 
then released. 

Minor number format: 0x110005. 

Modes 1 and 2 support most HP *J et series printers (LaserJ et, Desk] et, QuietJ et, etc.). 


AUTHOR 

cent was developed by HP. 

SEE ALSO 

lp(l), ioctl(2), intro(7), lp(7). 
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NAME 

clone - opens a major and minor device pair on a STREAMS driver 

DESCRIPTION 

The clone driver is a "pass through" device driver that allows other drivers to select unique minor device 
numbers on each open () . In effect, the driver passes an open operation through to the other driver. This 
mechanism allows for multiple instantiations of a driver, each with a different minor number, through a 
single device file. 

When the clone driver is opened, it is passed a major and minor device number by the operating system. 
The major number is the clone driver's major number (72), and the minor number is the major number of 
the driver the user wishes to clone (referred to here as the target driver). The clone driver calls the open 
routine of the target driver with the CLONEOPEN flag which specifies a clone open. The target driver's 
open routine allocates an unused minor number. The target driver must use makedev to make a new 
device number for the newly created device, and must set *devp to the new device number returned by 
makedev. The new device number is returned to the clone open through *devp. The clone open 
then returns to the user a file descriptor that points to the new instantiation of thetarget driver. 

The echo driver is an example of a clonable driver. 

Notes 

It is not possibleto do multipleopens of a device with the same major and minor number using the clone 
driver. This is because the clone driver is only given the major number of the driver to be cloned, and 
that driver will then select a minor number which has not been opened. 

When called with a pathname which corresponds to the donable driver, stat() will return different 
results than fstat () when it is called on a file descriptor returned from open () of the same clonable 
driver pathname. 

RETURN VALUES 

If the clone driver is given an invalid minor number, or if the driver indicated is not a clonabledriver, the 
open() fails and errno is set to [ENXIO], 

SEE ALSO 

open(2), fstat(2). 
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NAME 

console, systty, syscon - system console interface 

DESCRIPTION 

/dev/console provides a termio interface to the device configured as the system console. The initflM) 
man page discusses the uses of /dev/systty and /dev/syscon . 

Output data normally sent to the console, either through /dev/console or generated by a kernel 
printf, may be redirected to another terminal or pseudo-terminal device through the TIOCCONS 
ioctl(). Seetermio(7)for details. 

FILES 

/dev/console 

/dev/systty 

/dev/syscon 

SEE ALSO 

termio(7), init(lM). 

STANDARDS CONFORMANCE 

console: SVID2, SVID3, XPG2 
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NAME 

ct - Command-Set 80 (CS/80) cartridge tape access 

DESCRIPTION 

This entry describes the actions of the general hp-ux Command-Set 1980 (CS/80) cartridge tape drivers 
when referring to a CS/80 cartridge tape as either a block- or character-special (raw) device. 

Cartridge tapes are designed to work optimally as "streaming" devices, and are not designed to start and 
stop frequently. Technically, they are "random access" devices such as disks, but such access is both less 
efficient and more stressful than streaming mode. Thus it is possibleto use a cartridge tape as a file sys¬ 
tem, or in general access it randomly, but such use will more rapidly wear either or both the tape drive and 
the media. 

Cartridge tape units in either CS/80 disk drives or in stand-alone devices can be accessed as blocked or raw 
devices. 

Block special files access cartridge tapes via the system's normal buffering mechanism. Buffering is done in 
such a way that concurrent access through multiple opens or a mount of the same physical device do not 
get out of phase. Block special files may be read and written without regard to physical cartridge tape 
records. Each I/O operation results in one or more logical block transactions. I n general, this mode is not 
recommended as it stresses the hardware. 

There is also a raw interface via a character special file which provides for direct transmission between the 
cartridge tape and the user's read or write buffer. A single read or write operation results in exactly one 
transaction. Therefore raw I/O is considerably more efficient when many bytes are transmitted in a single 
operation because blocked cartridge tape access requires potentially several transactions and does not 
transmit directly to user space. 

In raw I/O, there may be implementation dependent restrictions on the alignment of the user buffer in 
memory and its maximum size. Also, each transfer must occur on a record boundary, and must read a 
whole number of records. The record size is a hardware-dependent value. 

Selecting the proper buffer size when accessing a cartridge tape device through the raw interface is critical 
to the performance of the cartridge tape device and other devices connected on the same hpib. A large 
buffer in certain situations can increase performance but has the potential to block other devices on the 
hpib until all the data for a request has been transferred. On the other hand when a small buffer is used 
and the application is unable to keep the cartridge tape device streaming, performance and the wear and 
tear of the device suffer because of tape repositioning. The optimal solution is to keep the tape streaming 
while using a small buffer. To select the proper buffer size, consider two factors: the cartridge tape device 
being accessed and the application which is accessing the cartridge tape device. 

Some cartridge tape units (see DEPENDENCIES) support a feature called immediate report mode. During 
writing, this mode enables the drive to complete a write transaction with the host before the data has actu¬ 
ally been written to the tape from the drive's buffer. This allows the host to start gathering data for the 
next write request while the data for the previous request is still in the process of being written. During 
reading, this mode enables the drive to read ahead after completing a host read request. This allows the 
drive to gather data for future read requests while the host is still processing data from the previous read 
request. When data is requested or supplied at a sufficient rate, immediate report mode allows the drive to 
stream the tape continuously across multiple read/write requests, as opposed to having to reposition the 
tape between each read/write request. Repositioning adds to the wear and tear of the cartridge tape device 
and decreases the performance. Some cartridge tape devices (see DEPENDENCIES) do not support 
immediate report mode and as such cannot stream across multiple requests. 

If the cartridge tape device being accessed supports immediate report mode and the application can main¬ 
tain a data rate that allows the cartridge tape device to stream multiple requests, a small buffer (1 Kbyte to 
12 Kbytes) is suggested so that theHP-iB is not blocked for a significant amount of time. For cartridge tape 
devices that do not support immediate report mode or applications that cannot maintain a data rate that 
allows the cartridge tape device to stream multiple requests, a large buffer (64 Kbytes) is suggested so that 
the number of tape repositions is reduced. 

Each raw access is independent of other raw accesses and of block accesses to the same physical device. 
Thus, transfers are not guaranteed to occur in any particular order. Flaving multiple programs access the 
cartridge tape is, in effect, random access, and is subject to the warnings above. 

In raw I/O, each operation is completed to the device before the call returns. For block-mode writes, the 
data may be cached until it is convenient for the system to write it. In addition, block-mode reads poten¬ 
tially do a one (or more) block read-ahead. The interaction of block-mode and raw access to the same 
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cartridge tape is not specified, and in general is unpredictable. Because block-mode writes can be delayed, 
it is possible for a program to generate requests much more rapidly than the drive can actually process 
them. Flushing a large number of requests could take several minutes, and during that time the system 
will not have use of the buffers taken by these requests, and thus will suffer a possibly severe performance 
degradation. If the tape is integral with the system disk, very little disk activity may be possible until the 
buffers are flushed. 

Cartridge tape device file names are in the foil owing format: 

/dev/[r]ct/[r]c#[d#] [s#] 

where the first r indicates a raw interface to the cartridge tape, the second r is reserved to indicate that 
this cartridge tape is on a remote system, the c#indicates the controller number, the d#optionally indi¬ 
cates the drive, and the s#optionally indicates a section number. The assignment of controller, drive, and 
section numbers is described in the system administrator's manual for your system. 

WARNINGS 

Like disks, the cartridge tape units in CS/80 disk drives can be accessed as blocked or raw devices. How- 
ever, using a cartridge tape as a file system severely limits the life expectancy of the tape drive. Tapes 
should be used only for system back-up and other needs where data must be stored on tape for transport or 
other purposes. 

ct does not support access of dds and QIC cartridge tape devices. 

DEPENDENCIES 

H P 7941CT/H P 9144A/H P 35401 

These cartridge tape devices support the immediate report mode. 

H P 7942/H P 7946 

These cartridge tape devices support the immediate report mode. The use of a small buffer size is 
not recommended with these shared controller devices when there is simultaneous access to the 
disk, because the disk accesses will prevent proper tape streaming. 

H P 7908/FI P 7911/FI P 7912/FI P 7914 

These cartridge tape devices do not support the immediate report mode. 


AUTHOR 

ct was developed by FHP and AT&T. 

SEE ALSO 

mknod(lM), tcio(l), disk(7), intro(7), mt(7). 
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NAME 

ddfa - Data Communications and Terminal Controller (DTC) Device File Access (DDFA) software 

DESCRIPTION 

The Data Communications and Terminal Controller (DTC) Device File Access (DDFA) software allows 
access from FIP-UX system utilities and user applications to terminal servers using standard FIP-UX struc¬ 
tures. DDFA provides an interface to remote LAN-connected terminal server ports that is similar to the 
interface for local directly-connected ports. 

The basic principle is that a daemon is created for each configured terminal server port based on informa¬ 
tion in a configuration file (a Dedicated Ports file). When the daemon is spawned, it takes a pty from the 
pool and creates a device file with the same major and minor number as the pty slave. The device file is 
known as the "pseudonym" and utilities and applications use the pseudonym to access the terminal server 
port by exercising standard FIP-UX system functions (open() , close () , read() , write () , and 
ioctl() ). The daemon listens on the pty until an application does an open() on the pseudonym. It 
then sets up and manages the connection to the terminal server port until the application does a close () 
on the pseudonym. The end result is that the terminal server port is addressed via a device file, but the 
mechanism that makes it happen is transparent to the user. A second configuration file (a port 
configuration file) contains information to profile the terminal server port. 

DDFA consists of the foil owing items: 

dp Dedicated Ports file. This text file contains the information that DDFA needs to set 

up and manage a connection between a pseudonym and a terminal server port. 

The dp file is parsed by the Dedicated Port Parser (dpp) which spawns an Outbound 
Connection Daemon (ocd) for each outbound connection specified in thefile. The dp 
file is also used by the FIP-UX Telnet daemon (telnetd) to identify incoming connec¬ 
tions from a DTC and map them to a pseudonym (the Telnet port identification 
feature). 

pcf Port Configuration File. This text file is used by DDFA to profile the terminal server 

port. The generic name of the template file is pcf . A port configuration file is refer¬ 
enced by an entry in the Dedicated Ports file (dp). 

dpp Dedicated Port Parser. This command parses the Dedicated Ports file (dp) and 

spawns an Outbound Connection Daemon (ocd) for each valid entry in thedp file. It 
can be run from the shell or it can be included in a system initialization script to 
automatically run the DDFA software each time the system is booted. 

ocd Outbound Connection Daemon. This daemon manages the connection and data 

transfer to the remote terminal server port. Normally, it is spawned by the Dedicated 
Ports Parser (dpp), but it can be run directly from the shell. 

As it starts, it creates its pseudonym for the connection. As it terminates normally, it 
removes the pseudonym. If the pseudonym is removed while it is running, ocd will 
terminate with an error condition. 

ocdebug Outbound Connection Daemon debug mode. This is a special version of ocd that con¬ 
tains debugging code. It must be run from the shell. 

CONFIGURATION 

Therearetwo basicsteps to configuring the DDFA software: 

• Enter information in thedp file. 

• Enter information in the port configuration files. 

Configuring the dp File 

The dp file contains one line for each outbound connection that is to be established and one line for each 
incoming connection request. A default file /usr/examples/ddfa/dp should be copied to a new file 
and the copy edited as needed. It is recommended that a directory be created to hold the dp file and the 
port configuration files. 

Each line of thedp file must contain the location of the terminal server port and the location of the pseu¬ 
donym. I n addition, for an outbound connection, the port configuration file must be specified and a logging 
level may be specified. 
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Configuring the Port Configuration Files 

A port configuration file is used to configure individual terminal server ports. A master port configuration 
file is /usr/examples/ddfa/pcf . In practice, it is renamed for each port that needs different 
configuration values and the values are altered appropriately for the device attached to the port. It is 
recommended that a directory be created to hold the port configuration files and the dp file. 

Each line of a port configuration file must consist of a name of a variable and its value. The variable-value 
pairs contain information on how to open a connection to a terminal server port, how to close a connection 
to a terminal server port, and how to manage the data transfer to a terminal server port. 

Configuring a System Initialization Script 

DDF A can be run at boot time by including a reference to dpp in a system initialization script. It is recom¬ 
mended that the -k option be used when running dpp in this environment. 

KILLING DAEMONS 

Note that ocd should be killed using kill -15. Do not use kill -9 for this purpose as it does not 
remove the device file, ocd verifies the validity of an existing pseudonym before trying to use it. dpp and 
ocd use data stored in the file /var/adm/utmp.dfa to verify whether a process still owns a pseu¬ 
donym before taking it over. If ocd finds an unowned pseudonym, it uses it. 

ERROR HANDLING 

When ocd receives a serious error condition, such as when the LAN goes down, it transmits the error con¬ 
dition to the application by closing thepty. Any open () , close () , read () , or write () to the pseu¬ 
donym returns the error condition 0 bytes read. If the pseudonym is the controlling terminal for the 
group to which the application belongs, SIGHUP is sent to all the processes in the group, including the 
application. 

ioctl() LIMITATIONS 

Not all ioctl () functionality is available, due to the lack of a protocol that allows the transmission of 
such commands over the LAN to the remote port. 

termio Attribute Limitations 

The main restrictions on termio attributes (see termio(7)) include modem signal control and parity check¬ 
ing. The following are not available: 

CBAUD IGNPAR INPCK IXANY IXOFF PARMRK 


ioctl() Request Limitations 

The following ioctl () request limitationsapply: 

CSTOPB flag DTC only supports on estop bit. 

CSIZE DTC only supports 8 bits per character. Value cannot be modified. 

PARODD flag DTC offers static configuration to handleeven or odd parity. It also handles auto 
parity detection for even or odd parity. 

PARENB flags Enabling/disabling donevia static configuration. No programmatic interface sup¬ 
plied. 

INPCK flag No way to separate input from output parity features. 

IGNPAR flag Cannot be configured on DTC. 

PARMRK Bad characters are forwarded to the system without marking them with OFF FI 

or OH. 

CBAUD Speed is part of static configuration. 

IXOFF flag Flow control is enabled if the DTC static configuration specifies an ASCI I access 

mode. If binary is selected, noflow control isprovided. 

IXON flags Pacing of output to a terminal via a programmatic interface is enabled when 

ASCII mode is selected in static port configuration and disabled when binary 
mode is selected. 

IXANY flag DTC does not offer the ability to restart output on any character received if 

XOFF was previously received. 
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HUPCL flag DDFA does not support the hanging up of modem signals on the last close of the 

device file. If the modem signalsused on theDTC drop, theconnection isclosed. 

CLOCAL flag Not supported. 

c_f lags IENQACK not supported. 

OFILL, OFDEL, NLDLY, CRDLY, TABDLY, BSDLY, FFDLY not Supported by 
Telnet port identification software. 

BINARY mode flags Part of static configuration isdonein DTC Manager by selecting binary mode. If 
switching is enabled, binary can be selected at user interface level. There is no 
way to automatically negotiate binary mode when proper termio flags are reset 
when using telnetd. Binary/ASCII switching is possible with DDFA. The 
DTC cannot support large reads in pure binary mode, so transferred blocks of 
data should not be more than 256 bytes. If half-duplex with remote ack¬ 
nowledgement is implemented, binary applications can be supported. 

ioctl() System Call Requests 

The following ioctl () system call limitationsapply: 

TCSBRK The ability to send a break without waiting for previous data to be sent is not 

provided at the system level in telnetd or DDFA. Receiving a Telnet break 
command in the DTC allows it to generate a break on asynchronous ports. 

TCFLSH TheDTC output queue cannot be flushed. 

Hardware handshake request 

Not supported on DTC. 

TCXONC Local handshakecannot bedisabledon DTC. 

MCGETA Not supported. 

MCSETA, MCSETAF, MCSETAW 

There is no way to separately set modem lines of a DTC port. 

MCGETT Modem timers, CD timer, connect timer, and disconnect cannot be configured. 

CCITT simple, and direct call-in/call-out modes 

DTC cannot handle simple mode because there is programmatic interface for 
modem signals. Call-in mode cannot be simulated if the port is opened, because 
modem signals (or the call) must be present within 2 minutes or the connection 
is cleared. 

DACIDY get device adapter info 

No way to get device adapter information. 

Download ioctl() DACRADDR, DACDLADDR, DACDLGO, DACDLVER 
No programmatic call to download the DTC. 

DACHWSTATUS, DACSELFTEST, DACLOADED, DACISBROKE Status 
No programmatic interface to get such info. 

DACLOOPBACK DACSUBTEST port test 

WARNINGS 

In order to ensure that commands (such as ps) display the correct device file name (that is, the pseu¬ 
donym), all pseudonyms should be placed into the directory /dev/telnet . If pseudonyms are not 
specified for placement in this directory, the correct display of device file names with many commands is 
not guaranteed. 

In addition, in order to ensure that commands (such as w, passwd, finger, and wall) work correctly, 
each pseudonym must be unique in its first 17 characters (including the directory prefix /dev/telnet / ). 
If pseudonyms are not unique in their first 17 characters, the correct functioning of many commands is not 
guaranteed. 

Also, in order to reliably handle timing mark negotiations (and ensure that files printing on a printer 
attached to a terminal server have been completely flushed to that printer), the following line must be 
added near the end of each printer interface script for printers attached to a terminal server: 
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stty exta <&1 2>/dev/null 

The printer interface scripts reside in the directory /etc/lp/interface. The line must be added just 
prior to the final exit command in each printer interface script. 

If this line is not added as specified, the printing reliability of printers attached to a terminal server is not 
guaranteed. 

FILES 

/usr/examples/ddfa/dp 
/usr/examples/ddfa/pcf 
/usr/sbin/dpp 
/usr/sbin/ocd 
/usr/sbin/ocdebug 
/var/adm/dpp_login.bin 
/var/adm/utmp.dfa 

SEE ALSO 

dpp(lM), ocd(lM), ocdebug(lM), ioctl(2), dp(4), pcf(4), ioctl(5), termio(7). 
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NAME 

diagO- diagnostic interface to I/O subsystem 


DESCRIPTION 

diagO is the diagnostic pseudo-driver used by the on-line diagnostic subsystem. Thekernel sends diagnos¬ 
tic events here for logging by the diagnostic subsystem. The diagnostic subsystem also sends diagnostic 
requests to the kernel via diagO. 

WARNINGS 

If the diagnostic subsystem does not read diagnostic events from diagO as fast as they are logged by the 
kernel, a warning message Warning: DIAGO — message queue full appears on the console. 

AUTHOR 

diagO was developed by HP. 


FILES 

/stand/vmunix 
/dev/diagO 
/dev/diag/diagO 

/dev/diag directory containing diagnostic device files 


SEE ALSO 

sysdiag(lM), diaginit(lM). 
OnlineDiagnosticSubsystem manuals. 
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NAME 

disk - direct disk access 

DESCRIPTION 

This entry describes the actions of HP-UX disk drivers when referring to a disk as either a block-special or 
character-special (raw) device. 

Device File Naming Conventions 

Standard disk device files are named according to the foil owing conventions: 

Block-mode Devices /dev/dsk/cxtydn[sm] 

Character-mode Devices /dev/rdsk/cxtydn[sm] 

where component parts of the filename are constructed as follows: 

c Required. Identifies thefollowing hexadecimal digits as the "Instance" of the interface card. 

x Hexadecimal number identifying controlling bus interface, also known as the "Instance" of 

this interface card. The instance value is displayed in the ioscan(lM) output, column "I" for 
theH/W Type, "INTERFACE". 

Required. 

t Identifies thefollowing hexadecimal digitsasa "drive number" or "target". 

Required. 

y Hexadecimal number identifying the drive or target number (bus address). 

Required. 

d Identifies thefollowing hexadecimal digits as a "unit number". 

Required. 

n Hexadecimal unit number within the device. 

Required. 

s Optional. Defaults to that corresponding to whole disk. Identifies the following value as a 
"section number". 

m Required if sisspecified. Defaults to section 0 (zero), whole disk. Drive section number. 

Assignment of controller, drive, logical unit and section numbers is described in the system administrator 
manuals for your system. 

Block-special access 

Block-special device files access disks via the system's block buffer cache mechanism. Buffering is done in 
such a way that concurrent access through multiple opens and mounting the same physical device is 
correctly handled to avoid operation sequencing errors. The block buffer cache permits the system to do 
physical I/O operations when convenient. This means that physical write operations may occur substan¬ 
tially later in time than their corresponding logical write requests. This also means that physical read 
operations may occur substantially earlier in time than their corresponding logical read requests. 

Block-special files can be read and written without regard to physical disk records. Block-special file 
read() and write () calls requiring disk access result in one or more BLKDEV_IOSIZE byte (typi¬ 
cally 2048 byte) transfers between the disk and the block buffer cache. Applications using the block-special 
device should ensure that they do not read or write past the end of last BLKDEV_I0SIZE sized block in 
the device file. Because the interface is buffered, accesses past this point behave unpredictably. 

Character-special access 

Character-special device files access disks without buffering and support the direct transmission of data 
between the disk and the user's read or write buffer. Disk access through the character special file inter¬ 
face causes all physical I/O operations to be completed before control returns from the call. A single read or 
write operation up to MAXPHYS bytes (typically 64 Kbytes or 256 Kbytes) results in exactly onedisk opera¬ 
tion. Requests larger than this are broken up automatically by the operating system. Since large I/O 
operations via character-special files avoid block buffer cache handling and result in fewer disk operations, 
they are typically more efficient than similar block-special file operations. 

There may be implementation-dependent restrictions on the alignment of the user buffer in memory for 
character special file read() and write() calls. Also, each read and write operation must begin and 
end on a sector boundary and must be a whole number of sectors in size. The sector size is a hardware- 
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dependent valuethat can be queried with the DI0C_DESCRIBE ioctl call, which is described below. 

In addition to reading and writing data, the character-special file interface can used to obtain device specific 
information and to perform special operations. These operations are controlled through use of ioctl calls. 
Details related to these ioctls are contained in <sys/diskio .h >. 

The DIOCDESCRIBE ioctl can be used to obtain device specific identification information. The informa¬ 
tion returned includes the disk's model identification, the disk interface type, and the disk's sector size. 

The DIOC CAPACITY ioctl can be used to obtain the capacity of a disk device in DEV_BSIZE units. 
(DEV_BSIZE is defined in <sys/param. h >). 

The DIOC EXCLUSIVE ioctl can be used to obtain and release exclusive access to a disk device. 
Exclusive access is required for some special operations, such as media reformatting, and may be desirable 
in other circumstances. The value one specifies that exclusive access is requested. The value zero specifies 
the exclusive access should be released. Exclusive access causes other open requests to fail. Exclusive 
access can only be granted when the device is not currently opened in block-mode and there is only one 
open file table entry for that disk device (the one accessible to the exclusive access requester). 

ERRORS 

The foil owing errors can be returned by a disk device driver call: 

[EACCES] Required permission is denied for the the device or operation. 

[enxio] If resulting from an open() call, this indicates there is no device at the specified 

address. For other calls, this indicates the specified address is out of range or the dev¬ 
ice can no longer be accessed. 

[einval] From an open() call: the device is not a disk device. For other calls: Invalid 
request or parameter. 

[ElO] I/O error (e.g., media defect or device communication problem). 

WARNINGS 

The interaction of block-special and character-special file access to the same BLKDEV_lOSlZE-sized block 
is not specified, and in general is unpredictable. 

On some systems, having both a mounted file system and a block special file open on the same device can 
cause unpredictable results; this should be avoided if possible. This is because it may be possiblefor some 
files to have private buffers in some systems. 

Although disk devices have historically had small (typically 512-byte) block sizes, some disk devices (such as 
optical disks and disk arrays) have relatively large block sizes. Applications using direct raw disk access 
should use ioctl () calls to determine appropriate I/O operation sizes and alignments. 

Any disk with removable media (for example, floppy or CD-ROM) containing a mounted file system should 
not be removed prior to being unmounted. Removal of disk media containing mounted filesystems is likely 
to result in file system errors and system panics. 

DEPENDENCIES 

disc 1/disc2/disc3/disc4 

Devices whose sector size is less than DEV_BSIZE must be accessed on DEV_BSIZE boundaries 
and with transfer sizes that are multiples of DEV_BSIZE. Disk "sections" 0 (zero) and 2 (two) have 
exchanged meanings with FIP-UX Release 10.0 and beyond. Whole disk is section 0. 


AUTHOR 

disk was developed by FH P and AT&T. 

SEE ALSO 

mknod(lM), ct(7), intro(7), ioscan(lM). 

System Administrator manuals included with your system. 
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NAME 

fddi - Fiber Distributed Data Interface Tools 

DESCRIPTION 

This manual entry provides general information on the HP-UX FDDI (Fiber Distributed Data Interface) 
link tools. 

Tools for HSC and EISA FDDI 

fddiif Display FDDI driver operating statistics in real-time, 
fddilink Display FDDI interface and network characteristics. 

Tools for PCI FDDI 

fddipciadmin Display FDDI interface, driver and network statistics and characteristics. 

Tools for HP-PB FDDI and S700 Built-in FDDI 

fddiinit InitializeFDDI network interface; connect to FDDI network. 

fddinet Display logical FDDI ring map information, 
fddistat Display status information for the FDDI interface, 
fddistop Stop and reset the FDDI interface. 

General Link Tools 

ifconf ig Configure or display IP interface information. 

ioscan Scan system for devices, display hardware path, class and description. 

lanadmin Display link information, RFC 1213 MIB 11 statistics, reset the interface card, perform card 
self-test. 

lanscan Scan system for LAN devices, display hardware path, station address (canonical format), 
instance number, hardware state, interface name, IP i nterface state, Network Management 
ID. 

linkloop Verify LAN connectivity with a link-level test frame. Requires the Physical Point of Attach¬ 
ment number (PPA) of the local interface and station address of the remote station in 
canonical format. The PPA is the numeric portion of the interface name. For example, the 
interface Ian2 has the PPA 2. Use lanscan on the remote system to get the remote sta¬ 
tion address in canonical format. 

netfmt Format network trace and log files created with the nettl utility (see below). FDDI entity 
names are FDDI (HP-PB and S700 built-in FDDI), EISAFDDI, HSC FDDI and 
PCIFDDI. 

netstat Show network statisticsfor IP interfaces and upper-layer protocols. 

nettl Start/stop network tracing and logging. FDDI entity names are FDDI (HP-PB and S700 

built-in FDDI), EISA FDDI, HSC_FDDI andPCI FDDI. 

ping Verify IP/ICMP connectivity to remote system. 

syslogd Read and log system messages (the FDDI drivers log system messages using syslog rou¬ 
tines). 

what Get version identification information. Use what /stand/vmunix to determine if the 

correct FDDI driver has been installed, according to thefollowing list: 

fddi (for HP-PB FDDI), fddiO (for EISA FDDI), fddi2 (for S700 built-in FDDI), fddi3 (for 
HSC FDDI), fddi4 (for PCI FDDI). 

FDDI station addresses are represented as a series of hexadecimal digits using canonical format, or wire or 
"native! 1 format. The canonical format uses Least Significant Bit (LSB) order. Wire or "native! 1 format uses 
Most Significant Bit (MSB) order. Most HP-UX FDDI and network utilities use canonical format (fddi¬ 
link and fddiif are two exceptions). The fddinet and fddistat commands display the addresses 
in canonical format by default and have a -n option to display the addresses in "native! 1 (wire) format. 
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SEE ALSO 

fddiinit(lM), fddinet(lM), fddipciadmin(lM), fddistat(lM), fddistop(lM), ioscan(lM), lanadmin(lM), 
lanscan(lM), netfmt(lM), netstat(l), nettl(lM), ping(lM), syslogd(lM), what(l). 
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NAME 

floppy - direct flexible or "floppy" disk access 

DESCRIPTION 

Flexible disk devices are removable-media disk devices that are typically used to share data with other sys¬ 
tems. Media types are identified by physical size (such as 3.5-inch and 5.25-inch), number of data surfaces 
(or sides), and data density. By convention, flexibledisk devices are named using the same conventions as 
those used for other disk devices (see disk(7)). 

Data can be stored on flexible disk media in a variety of logical formats. The capacity of these devices is 
generally too small to hold useful hp-ux file systems. Instead, DOS or LIF file systems (see dosif(4) and 
lif(4) for a detailed description of these file systems) are commonly used. Data can also be stored in an 
archive-utility format. For example, tar and cpio are commonly used to share data with other hp-ux 
systems (see tar (1) and cpio(l)). 

Logical volumes are not supported on flexible disks. The floppy disk does not support partitions. Section 
zero (0) istheonly accessiblepartition. 

In addition to the various logical formats, data can be stored on flexible disk media in a variety of physical 
data formats called geometries. The foil owing parameters are used to describe a flexible disk geometry: 

heads Number of surfaces (or sides) on the media that contain valid data. 

tracks Number of tracks on a single media surface or side (the term cylinders is sometimes 

also used). This value does not include spare tracks. 

sectors Number of sectors in a single track. The number of sectors that can fit on a track 

depends on the bit density (as controlled by transfer rate and media rotation rate) and 
the sector size. 

sector size Number of bytes in a logical sector. Since all I/O operations must be an integral 
number of sectors in length, this parameter also indicates the minimum character- 
special file I/O size. 

transfer rate Media data rate in Kbits per second. The transfer rate is an indirect means of 
representing bit density. Bit density is measured in bits per radian, and istheformal 
intra-track data density parameter for standard specification. Transfer rate is gen¬ 
erally used to program flexible media devices and is therefore more appropriate for 
this interface. Since the media rotation rate for most flexible disk devices is standard, 
conversion between these two representations is straight-forward. 

track density Number of tracks per inch. Some low density formats can be supported on high- 
density drives by skipping tracks during head stepping. 

data encoding Encoding method used to store data, fm (frequency modulation) and mfm (modified 
frequency modulation) are the most common encoding methods. 

The following table shows some useful flexible disk media geometries (without density information). The 
right-most column indicates which mediainit -f option should be used to format media to the indi¬ 
cated geometry (seemediainit(lM)). 
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Media Type 

Use 

Capacity 

Heads 

Tracks 

Sectors 

Sector Size 

-f 

3.5in DS DD 


630,784 

2 

77 

16 

256 

1 

3.5in DS DD 


655,360 

2 

80 

16 

256 

21 

3.5in DS DD 


655,360 

2 

80 

8 

512 

26 

3.5in DS DD 


709,632 

2 

77 

9 

512 

2 

3.5in DS DD 

DOS 720K 

737,280 

2 

80 

9 

512 

16 

3.5in DS DD 


788,480 

2 

77 

5 

1024 

3 

3.5in DS HD’ 

DOS 1.2M 

1,228,800 

2 

80 

15 

512 

26 

3.5in DS HD’ 


1,261,568 

2 

77 

8 

1024 

22 

3.5in DS HD 


1,261,568 

2 

77 

32 

256 

1 

3.5in DS HD 


1,419,264 

2 

77 

18 

512 

2 

3.5in DS HD 

DOS 1.44M 

1,474,560 

2 

80 

18 

512 

16 

3.5in DS HD 


1,567,960 

2 

77 

10 

1024 

3 

3.5in DS HD 


1,638,400 

2 

80 

10 

1024 

23 

5.25in DS 

DOS 360K 

368,640 

2 

40 

9 

512 

2 

5.25in DS DD 


655,360 

2 

80 

8 

512 

26 

5.25in DS HD 

DOS 1.2M 

1,228,800 

2 

80 

15 

512 

16 

5.25in DS HD 


1,261,568 

2 

77 

8 

1024 

24 


The foil owing table shows the density information for some standard flexible disk media. 


MediaType 

BitDensity 

RPM 

TransferRate 

TrackDensity 

DataEncoding 

3.5in DS DD 

7,958 

300 

250 

135 

MFM 

3.5in DS HD’ 

13,262 

360 

500 

135 

MFM 

3.5in DS HD 

15,916 

300 

500 

135 

MFM 

5.25in DS 

7,958 

300 

250 

48 

MFM 

5.25in DS DD 

7,958 

300 

250 

96 

MFM 

5.25in DS HD 

13,262 

360 

500 

96 

MFM 


Abbreviations are interpreted as follows: 

ds Double-sided media 

dd Double-density media 

hd High-density media 

HD' High-density media (alternate media rotation rate) 

Normally each open() call causes the device and/or floppy device driver to attempt to determine the 
geometry of the installed media. As a result, the current flexible disk geometry is set to the supported 
geometry that matches the physical data format on the media currently installed in the device. To main¬ 
tain reasonable open times, not all possible media geometries are checked. Therefore, it is possiblethat a 
flexible disk medium may contain valid data even though its format is not recognized. This automatic 
geometry sensing functionality may be disabled in some drivers by use of the 0_NDELAY flag in the 
open () call or device driver dependent minor numbers. The Series 800 does not support this flag. 

The FLOPPY_GET_lNFO ioctl indicates the characteristics and current status of a floppy device. Infor¬ 
mation for interpreting the media and data_encoding fields can be found in <sys/floppy .h >. 
The following macros are defined for decoding the status and valid fields. These macros return a 
non-zero (true) valuefor the associated conditions. 


FLOPPY_NO_MEDIA (x) 
FLOPPY_BLANK__MEDIA (x) 
FLOPPYWRITE PROT (x) 
FLOPPY_MEDIA„CHANGED (x) 
FLOPPY_HIGH_DENSITY (x) 


/* Drive is empty */ 

/* Media geometry is not recognizable*/ 
/* Media is write protected */ 

/* Media has changed since last status */ 
/* Media has high density indication */ 


The argument x in the above macros refers to the status or valid fields of the 
FLOPPY_GET_lNFO ioctl. Some floppy devices or floppy device drivers may be unable to determine some 
status information. The valid field indicates whether or not the corresponding status information is 
meaningful. Applying a macro to the valid field indicates whether or not the application of that same 
macro to the status field results in a valid device status. 
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The FLOPPY_GET_GEOMETRY ioctl can be used to determine the flexible disk device's current media 
geometry. Current geometry parameters are indicated in thefields of the resultant floppy_geometry 
structure. 


The FLOPPY_SET_GEOMETRY ioctl can be used to specify the desired media geometry. Exclusive access 
to the device, obtained through use of the DI0C_EXCLUSIVE ioctl (see disk(7)), is required prior to set¬ 
ting the media geometry. Exclusive access is necessary to ensure that other applications are not affected. 
The Series 800 does not support this ioctl. 

The FLOPPY_FORMAT_TRACK ioctl can be used to reformat a media track. Exclusive access to the dev¬ 
ice, obtained through use of the DI0C_EXCLUSIVE ioctl (see disk(7)), is required prior to reformatting to 
ensure that other applications are not affected. The Series 800 does not support this ioctl. 


Flexible disk devices support the generic disk ioctl s (see disk(7)), typically used for hard disk devices. Flex¬ 
ible disk device drivers may also support driver specific ioctls (see the appropriate driver manual section). 

The header file <sys/f loppy. h> has useful information for flexible-media device control. The following 
is included from <sys/floppy .h >: 


/* ioctls for flexible (floppy) 
#define FLOPPY_GET_INFO 
#define FLOPPY GET GEOMETRY 
#define FLOPPY_SET_GEOMETRY 
#define FLOPPY_FORMAT_TRACK 


disk devices 

*/ 


_IOR('F', 

1, 

struct 

floppy_info) 

_IOR('F', 

2, 

struct 

floppy_geom) 

_IOW('F', 

3, 

struct 

floppy_geom) 

IOW('F', 

4, 

struct 

f1oppy_fo rmat) 


/* structure for FLOPPY_GET_INFO ioctl */ 
struct floppy_info { 

unsigned media; 

unsigned status; 

unsigned valid; 

} ; 


/* structure for FLOPPY_GET_GEOMETRY and FLOPPY_SET_GEOMETRY ioctls */ 
struct floppy_geometry { 

unsigned heads; 

unsigned tracks; 

unsigned sectors; 

unsigned sector_size; 

unsigned transfer_rate; 

unsigned track_density; 

unsigned data_encoding; 

} ; 


/* structure for FLOPPY_FORMAT_TRACK ioctl */ 
struct floppy_format { 

unsigned head; 

unsigned track; 

unsigned interleave; 

} ; 


ERRORS 

The following errors can be returned by a flexible-disk device-driver call: 

[EACCES] Required permission is denied for the the device or operation. 

[enxio] If resulting from an open call, this indicates there is no device at the specified address. 

For other calls, this indicates the specified address is out of range or the device can no 
longer be accessed. 

[EINVAL] From an open() call: the device is not a floppy device. For other calls: Invalid 
request or parameter. 

[ElO] I/O error (e.g., media defect or device communication problem). 

WARNING 

Media removal and/or replacement while the device is open is not supported. A floppy disk containing a 
mounted file system should not be removed prior to being unmounted. Removal of floppy disks containing 
mounted file systems is likely to result in file system errors, and system panics. 
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Reformatting flexible disk media from one geometry to another that differs only in that it has fewer tracks 
can cause the automatic geometry sensing functionality of open() to fail to recognize the new media 
geometry. Bulk erasing (degaussing) the media or formatting the media to a substantially different 
geometry prior to reformatting prevents automatic geometry sensing problems. 

Single track formatting may not be supported by some floppy devices. 

Some devices permit configuration for geometries which they are unable to support. The 
floppy set geometry ioctl for such a configuration may not result in an error. However, subsequent I/O 
operations will fail. 

DEPENDENCIES 
Series 700 

Series 700 device special files reside in the directories /dev/rfloppy and /dev/floppy. 

Series 800 

A flexible disk can be opened with no media. However, capacity changes resulting from subsequent media 
changes will not be recognized. (See scsi_disk(7)). 

Series 800 device special files reside in the directories /dev/rdsk and /dev/dsk. 

The following table of Series 800 Flexible Disk Media shows the disk geometries supported. The media 
inserted in the drive is formatted depending on the presence or absence of the HD hole in theflexibledisk 
cartridge. HD media is formatted as a 1.44M diskette and DD media is formatted as a 720K diskette. 


Media Type 

Use 

Capacity 

Heads 

Tracks 

Sectors 

Sector Size 

3.5in DS DD 

DOS 720K 

737,280 

2 

80 

9 

512 

3.5in DS HD 

DOS 1.44M 

1,474,560 

2 

80 

18 

512 


Thefollowingtableshowsthedensity information for theflexibledisk media supported: 


MediaType 

BitDensity 

RPM 

TransferRate 

TrackDensity 

DataEncoding 

3.5in DS DD 

7,958 

300 

250 

135 

MFM 

3.5in DS HD 

15,916 

300 

500 

135 

MFM 


The FL0PPY_GET_INF0 and FLOPPY_GET_GEOMETRY ioctls are supported on Series 800. 

SEE ALSO 

disk(7), mediainit(l), mknod(lM), dosif(4), lif(4), scsi(7), scsi_disk(7). 
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NAME 

framebuf - information for raster frame-buffer devices 


SYNOPSIS 

#include <sys/framebuf. h> 


DESCRIPTION 

Frame-buffer devices are raster-based displays. These devices use memory-mapped I/O to obtain much 
higher performance than possible with tty-based graphic terminals. Frame-buffer devices can be accessed 
directly using this interface, although access through the STARBASE libraries is recommended (see 
starbase(3G)). Direct access to frame-buffer devices entails precise knowledge of the frame-buffer architec¬ 
ture being used. Input cannot be piped into or redirected to frame-buffer devices because they are not 
serial devices. 

Each frame-buffer device is associated with a character special file. Major and minor numbers for frame- 
buffer devices are implementation-dependent. The minor numbers for these devices denote different frame 
buffers. I mplementation-specific details are discussed in the appropriate systems administrator's manuals. 

Communication with a frame-buffer device begins with an open(2) system call. Multiple processes can have 
the frame-buffer device open concurrently. 

dose(2) invalidates the file descriptor associated with the frame-buffer device. After a close system call, 
any access to the frame-buffer device address range might result in a memory fault and the signal SIGSEGV 
being sent to the process (see signal (2)). A process cannot unmap the frame buffer from its address space 
after the frame-buffer special file is closed. To unmap a frame buffer, use the GCUNMAP ioctl (2) call (see 
below). 

Once a process acquires a lock for the frame-buffer device, it must unlock it explicitly before calling dose(2); 
see GCUN lock below. 

read(2) and write(2) system calls are undefined and always return an error. In this case errno is set to 
ENODEV. 


The ioctl (2) system call is used to control a frame-buffer device. The select(2) system call is used to test the 
frame-buffer device for exceptional conditions. I nterrupts from thegraphic hardware are considered excep¬ 
tional conditions. An exceptional condition is automatically cleared after any process that opens the frame- 
buffer device is notified of the exception by a select(2) call. A call to select(2) for read or write on the file 
descriptor associated with the frame-buffer device returns a false condition in the read and write bit masks 
(seeselect(2)). 

A frame-buffer device can be accessed by multiple processes at once. Flowever, each process overwrites the 
output of the others unless one of the lock mechanisms described here or some other synchronization 
mechanism is used. The lock mechanisms described here are intended for cooperating processes only. 

For all frame buffers, data bytes scan from left to right and from top to bottom. A pixel, which is a visible 
dot on the screen, is associated with a location in the frame buffer. Each device maps one or more bits in 
memory to a pixel on the screen, although the bits in the frame buffer might not be continuous. I nforma- 
tion describing the frame-buffer structure and attributes is found in the crt_frame_buffer_t data 
structure. The crt_frame„buffer_t data structure includes thefollowingfields: 


int crt_id; 

unsigned int crt_attributes; 

char *crt_frame base; 
char *crt control base; 


/♦display identifier*/ 

/♦flags denoting attributes*/ 

/♦first byte in frame-buffer memory*/ 
/♦first byte of the control*/ 
/♦registers*/ 


char *crt_region [ CRTMAXREGIONS ]; 

/♦other regions associated with the*/ 
/♦frame-buffer device*/ 

The following are valid ioctl (2) requests: 

GCDESCRI be Descri be the size, characteristics, and mapped regions of the frame buffer. Theinfor- 

mation is returned to the calling process in a crt_frame_buffer_t data struc¬ 
ture, and the parameter is defined as crt_frame_buffer_t *arg;. Although 
some structure fields contain addresses of one or more frame-buffer device regions, 
the values of these fields are not always defined. Only after a successful GCMAP com¬ 
mand is issued (see below) are the correct addresses returned so the user can access 
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GCID 

GCON, 

GCAON, 

GCMAP 


GCUNMAP 

GCLOCK 


GCLOCKNOWAIT 

GCLOCK BLOCKSIG 


the frame-buffer regions directly using the returned addresses. 

Provide a device identification number. The parameter is defined as int *arg;. 
The information returned when using this command is a subset of the information 
provided by GCDE scribe, and is provided here for backward compatibility only. 

GCOFF Turn graphics on or off. These operations are valid for devices whose 
CRT GRAPHICS ON OFF bit is set in the crt_attributes field of the 
crt_frame_buffer_t data structure returned by the GCDESCRIBE command. 
Otherwise, these commands have no effect. 

GCAOFF Turn alpha on or off. These operations are valid for devices whose 
CRTALPHAONOFF bit is set in the crt_attributes field of the 
crt_frame_buf fer_t data structure returned by the GCDESCRI BE command. 
Otherwise, these commands have no effect. 

Make the frame-buffer memory, graphics control, and other device regions accessible 
to the user process making the call. Only processes that request this can directly 
access frame-buffer memory and control registers. After a successful GCMAP call, the 
fields crt_f rame_base and crt_control_base in the 
crt_frame_buf fer_t data structure (returned by a subsequent GCDESCRI BE 
ioctl (2) call), hold the valid addresses of these two regions of the frame buffer. If, for a 
specific device, more than two regions are to be mapped to the user's address space, 
the base addresses of up to crt max regions extra device regions will be placed in 
the array crt_region in successive order. Only the regions pertinent to a specific 
frame buffer are mapped. Irrelevent region fields in the crt_frame_buffer_t 
data structure are set to 0. Use of the arg parameter is implementation dependent 
(see dependencies below). The base addresses for frame-buffer regions are always 
page aligned. 

Cause access to the frame-buffer memory, graphics control, and possibly other device 
regions to be removed from the requesting process. The parameter arg is ignored and 
should be set to 0. Any attempt to access these memory regions after a successful 
GCUNMAP call results in a memory fault and sends the signal sigsegv to the process. 

Provide for exclusive use of the frame-buffer device by cooperating processes. The cal¬ 
ling process either locks the device and continues or is blocked. Blocking in this case 
means that the call returns only when the frame buffer is avail able or when the call is 
interrupted by a signal. If the call is interrupted, it returns an error and errno is 
set to eintr. Waiting occurs if another process has previously locked this frame 
buffer using the GCLOCK command and has not executed a GCUNLOCK command yet. 
The GCLOCK command does not prevent other non-cooperating processes from writing 
to the frame buffer; thus, GCLOCK is an advisory lock only. The parameter arg is 
ignored and should beset to 0. 

This call prevents the Internal Terminal Emulator (ite ) from corrupting the state of 
the graphics hardware (see termio(7)). On some systems, as long as the frame buffer 
is locked with a GCLOCK command, the ite does not output text to it (see dependen¬ 
cies below). Any attempt to lock the device more than once by the same process fails, 
and causes errno to be set to EBUSY. 

Provide for exclusive use of the frame-buffer device by cooperating processes. This 
request has the same effect on the frame-buffer device as does the GCLOCK request. 
Flowever, this call does not wait for theframe buffer to be released by other processes. 
If the frame-buffer device is locked, the process is not blocked; instead, the system call 
returns an error and causes errno to be set to eagain. The parameter arg is 
ignored and should beset to 0. 

Provide for exclusive use of the frame-buffer device by cooperating processes while 
blocking all incoming signals for the calling process that otherwise might have been 
caught. This call is a superset of the GCLOCK call. The parameter arg is ignored and 
should be set to 0. When the display is acquired for exclusive use (and thus locked), 
all signals sent to the process that otherwise would have been caught by the process at 
the time of the GCLOCK call, are withheld (blocked) until GCUNLOCK is requested. 
Any attempt to modify the signal mask of the process (see sigsetmask(2)) before a 
GCUNLOCK request is made will not have any effect on these blocked signals. Thesig- 
nals are not blocked until the lock is actually acquired, and might be received while 
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GCLOCKBLOCKSIG 

GCU N LOCK 

GCRESET 

GCDMA OUTPUT 


still awaitingthe lock. 

The signal SIGTSTP is also blocked whether or not it is being caught. The signals 
sigttin andSiGTTOU are also blocked on frame-buffer devices where the ite does not 
output to the device while it is locked. See dependencies below. 

Except for the three signals mentioned above, this call does not block signals that the 
process did not expect to catch, nor does it block signals that cannot be caught or 
ignored. This command does not prevent other non-cooperating processes from writ¬ 
ing to the frame buffer. 


NOWAIT 

Provide for exclusive use of the frame-buffer device by cooperating processes, while 
blocking all incoming signals for the calling process that otherwise would have been 
caught. This request has the same effect on the frame-buffer device as does the 
GCLOCKBLOCKSIG request. However, this call does not wait for the frame buffer to 
be released by other processes. If the frame-buffer device is locked, the process is not 
blocked, but the system call returns an error and causes errno to be set to eagain. 
The parameter arg is ignored and should beset to 0. 

Relinquish exclusive use of the frame-buffer device. If the device is locked with a 
GCLOCK BLOCKSIG or GCLOCK BLOCKSIG NOWAIT ioctl (2) request, thesignal mask of 
the calling process is restored to its state prior to the locking request. 

Reset the graphic hardware associated with the frame-buffer device to a defined initial 
state. The call enables the frame-buffer device to respond to the ioctl requests defined 
here. 


Send DMA output to the frame-buffer device. This system call is used to transfer data 
from a user's array to a rectangular area of the graphics frame-buffer, or optionally, to 
the device's graphics control space. 


The parameters for the DMA are passed in a "crt_dma_ctrl_t" data structure, which 
includes the foil owing fields: 


char *mem addr; 
char * fb addr; 
int length; 
int linelength; 
int skipcount; 
unsigned int flags; 


/* Starting address of data 
being transferred */ 

/* Address of framebuffer 
destination */ 

/* Number of bytes to transfer, 
including those "skipped" */ 

/* Number of bytes written 
on each framebuffer row */ 

/* Number of source bytes to 
ignore after each "linelength" */ 

/* Specified options to the driver */ 


To write to the graphics frame-buffer, set fb_addr to the address of the upper-left 
corner of the rectangle to be drawn. TheDMA will write linelength bytesoneach 
frame-buffer row, ignore the next skipcount bytes of memory data, then resume 
writing at the same starting position on each succeeding frame-buffer row. This is 
continued until length bytes are either written or ignored. 

To write to the graphics control space, set fb_addr to the address of the first 
graphics control register to write. In this case, linelength and skipcount are 
ignored. 


The flags parameter specifies options for the DMA. Currently, there are no sup¬ 
ported flags and this parameter should be set to zero, otherwise the system call will 
fail and errno is set to EINVAL. 


The DMA has the same effect on the frame-buffer device as using store instructions to 
write the data. Thus, various graphics control registers may affect the results of the 
DMA. It is the responsibility of the user program to perform any necessary set-up of 
the frame-buffer device so that the DMA has the desired results. 


The skipcount parameter allows the user to refresh a portion of a window image 
that the user has stored in memory for those cases where only a portion of the image 
needs to be refreshed. The window image is then a superset of the rectangle being 
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updated, and might thus have different dimensions. The skipcount specifies the 
portion of the row in the larger window image that is excluded from the rectangle. 
Thus, linelength plus skipcount would be the number of bytes in each row of 
the larger window image array. 

If a particular framebuffer device supports this system call, the CRT_dma output 
flag in the crt_attributes field of the crt_frame_buffer_t structure is 
set. Some framebuffer devices supporting DMA might restrict alignment of the vari¬ 
ous parameters, and are specified in the dependencies section below. The kernel 
ensures that these restrictions are obeyed, and if they are not the system call will fail 
and set errno to EINVAL. 

It is the responsibility of the application to guarantee that the system's physical 
memory is up-to-date by flushing the processor's data cache. One should use the 
GCDMA DATAFLUSH ioctl to ensure that the data is consistent before initiating a DMA 
transfer. 

GCDMA DATAFLUSH Flush the specified data from the processor's data cache to the system's main memory. 

This system call is intended to be used before DMA to ensure that an up-to-date ver¬ 
sion of the data is transferred to the framebuffer or to control space. 

The parameters for the flush are passed in a crt_flush_t data structure, which 
includes the foil owing fields: 

char *flush_addr; /* Starting address of data 
to be flushed */ 

int flush len; /* Number of bytes to flush */ 

The kernel ensures that the flush_len bytes starting at flush_addr are con¬ 
sistent in main memory with respect to the cache. 

GCSLOT Provide pertinent information about the calling process's participation in the system- 

wide graphics locking mechanism (see the discussion under GCLOCK above). The 
GCSLOT request does not carry out any actual locking functionality. The lock informa¬ 
tion is returned to the calling process in a crt_gcslot_t data structure. The 
parameter is defined as crt_gcslot_t *arg; . The crt_gcslot_t data 
structure is defined in the file <sys/framebuf.h>. 

GCSTATIC_map Prevent the I nternal Terminal Emulator (ite) from modifying the device's color map. 
GCVARIABLE MAP Allow the I nternal Terminal Emulator (ite) to modify the device's color map. 

DEPENDENCIES 

Series 700/800 

When requestingGCMAP, the parameter arg is ignored and should beset to 0. 

All supported ites ignore the frame buffer lock for output. 

Series 700 

Among the device identification constants that can be returned both by the GCID call and in the 
crt_id field of the crt_frame_buf fer_t data structure by the GCDESCRIBE call are: 

S9000_ID_98705 

S9000_ID„98736 

S9000_ID_A1659A 

S9000_ID_A1439A 

If a memory-mapped graphics co-processor is available, it is mapped in with other graphics regions as 
the result of a GCMAP call, and its addres is recorded as the last entry in the crt region array returned 
by theGCDESCRI be call. 

Series 800 

The following device identification constants are returned both by the GCID call and in the crt_id 
field of the crt_frame_buf fer_t data structure by theGCDESCRlBE call: 

S9000_ID_98720 

S9000_ID„98730 

S9000_ID„98550 
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For the HP A1047A I nterface Card, the fields of the crt_dma_info structure have the following res¬ 
trictions: 


mem_addr 

fb_addr 

length 

skipcount 


32-byte aligned 
16-byte aligned 
non-zero multiple of 32 
0 


ERRORS 

[EAGAIN] 

[EBUSY] 

[EINTR] 

[EINVAL] 

[ENODEV] 

[ENOMEM] 

[ENOSPC] 

[ENXIO] 

[EPERM] 


The operation would result in suspension of the calling process, but the request was either 
GCLOCK NOWAIT or GCLOCKBLOCKSIGNOWAIT. 

Attempted to lock the device, which is already locked by the same process. 

A call to ioctl (2) was interrupted by a signal. 

An invalid ioctl (2) command was made. 

Attempted to use read (2) or write(2) system calls on the device. 

Sufficient memory for mapping could not be allocated. 

Required resources for mapping could not be allocated. 

The minor number on the device file refers to a nonexistent device. 

Requested GCUNLOCK ioctl (2) command, but the device was locked by a different process. 


AUTHOR 

framebuf was developed by HP. 


SEE ALSO 

select(2), open(2), close(2), signal(2), sigsetmask(2), lockf(2), ioctl(2), mknod(lM), starbase(3G), termio(7). 
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NAME 

hil-HP-HiL device driver 

SYNOPSIS 

#include <sys/hilioctl.h> 

DESCRIPTION 

HP-HIL, the Hewlett-Packard Human Interface Link, is the Hewlett-Packard standard for interfacing a 
personal computer, terminal, or workstation to its input devices, hil supports devices such as keyboards, 
mice, control knobs, ID modules, button boxes, digitizers, quadrature devices, bar code readers, and 
touchscreens. 

On systems with a singlelink, HP-HIL device filenames use thefollowingformat: 

/dev/hiln 

where n represents a single digit that specifies the physical HP-HIL device address, which ranges from 1 to 
7. For example, /dev/hil3 is used to access the third HP-HIL device. 

On systems with more than one link, HP-HIL device file names use thefollowingformat: 

/dev/hil_m.n 

where m represents the instance number, and n represents the physical HP-HIL device address. For exam¬ 
ple, /dev/hil_0.2 would be used to access the second device on the link which has an instance number 
of zero. Likewise, /dev/hil_12.7 references the seventh device on the link with instance number 
twelve. 

Note that HP-HIL device addresses are determined only by the order in which devices are attached to the 
link. The first device attached to the link becomes device one, the second device attached becomes device 
two, etc. 

HP-HIL devices are classified as "slow" devices. This means that system calls to hil can be interrupted by 
caught signals (see signal (5)). 

hil can only read HP-HIL keyboards in raw keycode mode. Raw keycode mode means that all keyboard 
input is read unfiltered. HP-HIL keyboards return keycodes that represent key press and key release 
events. 

Use hi I kbd(7) to read mapped keycodes from HP-HIL keyboards. Use the Internal Terminal Emulator 
(ite) described in termio(7) to read ASCII characters from HP-HIL keyboards. 

System Calls 

open (2) gives exclusive access to the specified HP-HIL device. Any previously queued input from the device 
is discarded. If the device is a keyboard, it is opened in raw keycode mode. A side effect of opening a key¬ 
board in raw keycode mode is that the ITE (see termio(7)) and mapped keyboard driver (see hi I kbd(7)) lose 
input from that keyboard until it is closed. Only device implemented auto-repeat functionality is available 
while in raw keycode mode (see HI LERI and HI LER2). 

The file status flag, 0_N DELAY, can be set to enable non-blocking reads (see open(2)). 

dose(2) returns an HP-HIL keyboard to mapped keycode mode, making its input availableto the ITE or 
mapped keyboard driver (see hi I kbd(7)). 

read(2) returns data from the specified HP-HIL device, in time-stamped packets: 

unsigned char packet_length; 
unsigned char time_stamp[4]; 
unsigned char poll_record_header; 
unsigned char data[ packet_length - 6 ] ; 

packetjength specifies the number of bytes in the packet including itself, and can range from six to twenty 
bytes. time_stamp, when re-packed into an integer, specifies the time, in tens of milliseconds, that the sys¬ 
tem has been running since the last system boot. The most significant byte of the time stamp is 
time_stamp[0]. poll_record_header indicates the type and quantity of information to follow, and reports 
simple device status information. The number of data bytes is device dependent. Refer to the text listed in 
SEE ALSO for descriptions of the poll_record_header and device-specific data. 

Usually two system calls are required to read each data packet, the first system call reads the data packet 
length; the second system call reads the actual data packet. Some devices always return the same amount 
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of data in each packet, in which case the count and the packet can both be read in the same system call. 

If the file status flag, 0_N DELAY, is set and no data is available, read(2) returns 0 instead of blocking. 
write(2) is not supported by hil. 

select(2) can be used to poll for available input from HP-HIL devices. select(2) for write or for exception 
conditions always returns a false indication in the file descriptor bit masks. 

ioctl (2) is used to perform special operations on HP-HIL devices, ioctl (2) system cal I sal I havetheform: 

int ioctl(int fildes, int request, char *arg); 

The foil owing request codes are defined in <sys/hilioctl. h>: 

HI LID Identify and Describe 

This request returns the Identify and Describe Record in the char variableto which arg 
points, as supplied by the specified HP-HIL device. The Identify and Describe Record is 
used to determine the type and characteristics of each device connected to the link. The 
I dentify and Describe Record can vary in length from 2 to 11 bytes. The record contains at 
least: 

• A Device ID byte, and 

• A Describe Record Header byte. 

The Device ID byte is used to identify the general class of a device, and its nationality in 
the case of a keyboard or keypad. The Describe Record Header byte describes the position 
report capabilities of the device. The Describe Record Header byte also indicates if an I/O 
Descriptor byte follows at the end of the Describe Record. It also indicates support of the 
Extended Describe and the Report Security Code requests. If the device is capable of 
reporting any coordinates, the Describe Record contains the device resolution immediately 
after the Describe Record Header byte. If the device reports absolute coordinates, the max¬ 
imum count for each axis is specified after the device resolution. The I/O Descriptor byte 
indicates how many buttons the device has. The I/O Descriptor byte also indicates device 
proximity detection capabilities and specifies Prompt/Acknowledge functions. All HP-HIL 
devices support the Identify and Describe request. 

HILPST Perform Self Test 

This request causes the addressed device to perform its self test, and returns the one-byte 
test result in the char variableto which arg points. A test result of zero indicates a suc¬ 
cessful test, non-zero results indicate device-specific failures. All HP-HIL devices support 
theSelfTest request. 

HILRR Read Register 

The Read Register request expects an HP-HIL device register address in the char variable 
to which arg points, and returns the one-byte contents of that register in *arg. The 
Extended Describe Record indicates whether a device supports the Read Register request. 

HILWR Write Register 

The Write Register request expects *arg to contain a record containing one or more packets 
of data, each containing the HP-HIL device register address and one or more data bytes to 
be written to that register. There are two types of Register Writes. Type 1 can be used to 
write a single byte to each individual device register. Type 2 can be used to write several 
bytes to one register. The Extended Describe Record indicates if a device supports either or 
both types of register write requests. 

HILRN Report Name 

The Report Name request returns the device description string in the character array to 
which arg points. The string may be up to fifteen characters long. The Extended Describe 
Record indicates support of the Report Name request. 

HILRS Report Status 

The Report Status request returns the device-specific status information string in the char¬ 
acter array to which arg points. The string can be up to fifteen bytes long. The Extended 
Descri be record indicates support of the Report Status request. 
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HILED Extended Describe 

The Extended Describe request returns the Extended Describe Record in the character 
array to which arg points. The Extended Describe Record may contain up to fifteen bytes 
of additional device information. The first byte is the Extended Describe Header, which 
indicates whether a device supports the Report Status, Report Name, Read Register, or 
Write Register requests. If the device implements the Read Register request, the max¬ 
imum readable register is specified. If the device supports the Write Register request, the 
Extended Describe Record specifies whether the device implements either or both of the 
two types of register writes and the maximum writeable register. If the device supports 
Type 2 register writes, the maximum write buffer size is specified. The Extended Describe 
Record can also contain the localization (language) code for a device. Support of the 
Extended Describe request is indicated in the Describe Record Header byte. 

HILSC Report Security Code 

The Report Security Code request returns the Security Code Record in the character array 
to which arg points. The Security Code Record can be between one and fifteen bytes of 
data that uniquely identifies that particular device. Applications can use this request to 
implement a hardware "key" that restricts each copy of the application to a single machine 
or user. An application can read the Security Code Record from an HP-HIL ID Module and 
then verify that the application is running on a specific machine or that the application is 
being used by a legitimate user. Devices indicate support of the Report Security Code 
request in the Describe Record Header. 

HI LERI EnableAuto Repeat Rate = 1/30 Second 

This request is used to enablethe "repeating keys" feature implemented by thefirmware of 
some HP-HIL keyboard and keypad devices. It also sets the cursor key repeat rate to 1/30 
sec. This request does not use arg. 

HI LER2 EnableAuto Repeat Rate = 1/60 Second 

This request is used to enablethe "repeating keys" feature implemented in thefirmware of 
some HP-HIL keyboard and keypad devices. It also sets the cursor key repeat rate to 1/60 
sec. This request does not use arg. 

HILDKR DisableKeyswitch Auto Repeat 

This request turns off the "repeating keys" feature implemented in the firmware of some 
HP-HIL keyboard and keypad devices. This request does not use arg. 

HI LP1..HILP7 Prompt 1 through Prompt 7 

These seven requests are supported by some HP-HIL devices to give an audio or visual 
response to the user, perhaps indicating that the system is ready for some type of input. A 
device specifies acceptance of these requests in the I/O Descriptor Byte in the Describe 
Record. These requests do not use arg. 

HILP Prompt (General Purpose) 

This request is intended as a general purpose stimulus to the user. Devices accepting this 
request indicate so in the I/O Descriptor Byte in the Describe Record. This request does 
not use arg. 

HI LAI..HI LA7 Acknowledge 1 through Acknowledge 7 

These seven requests are intended to provide an audio or visual response to the user, gen¬ 
erally to acknowledge a user's input. The I/O Descriptor Byte in the Describe Record indi¬ 
cates whether an HP-HIL device implements this request. These requests do not use arg. 

HILA Acknowledge (General Purpose) 

The Acknowledge request is intended to provide an audio or visual response to the user. 
Devices accepting this request indicate so in the I/O Descriptor Byte in the Describe 
Record. This request does not use arg. 
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ERRORS 

[EBUSY] The specified HP-HIL device is already opened. 

[E FAULT] A bad address was detected while attempting to use an argument to a system call. 

[ElNTR] A signal interrupted an open(2), read(2), or ioctl (2) system call. 

[El NVAL] An invalid parameter was detected by ioctl (2). 

[ENXIO] No device is present at thespecified address; see WARNI NGS, below. 

[EIO] A hardware or software error occurred while executing an ioctl (2) system call. 

[ENODEV] write(2) is not implemented for HP-HIL devices. 

WARNINGS 

An ENXIO error is returned by open (2) and ioctl (2) if any attempt is made to access a device while hil is 
reconfiguring the link during power-failure recovery. 

hil cannot detect whether or not a device executed an ioctl (2) request. 

HP-HIL devices have no status bit availableto indicate whether they support the HILER1, HILER2, or 
HI LDKR requests. 

AUTHOR 

hil was developed by the Hewlett-Packard Company. 


FILES 

/dev/hil[1-7] 
/dev/hil_*.[1-7] 


SEE ALSO 

dose(2), errno(2), fcntl(2), ioctl(2), open(2), read(2), select(2), signal(5), hiIkbd(7), termio(7). 

For detailed information about HP-HIL hardware and software in general, see the HP-H IL Technical Refer¬ 
ence Manual . 
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NAME 

hilkbd- HP-HIL mapped keyboard driver 

DESCRIPTION 

hp-hil, the Hewlett-Packard Human I nterface Link, istheHewlett-Packard standard for interfacinga per¬ 
sonal computer, terminal, or workstation to its input devices, hilkbd supplies input from all mapped key¬ 
boards on a specified hp-hil link, 

hilkbd returns mapped keycodes, not ascii characters. "Raw" keycodes are the individual key downstrokes 
and upstrokes, and are different for each type of keyboard, hilkbd maps the raw input into the keycodes 
and protocol expected by the hp-ux, Pascal Workstation, and basic/ux operating systems. The hi I (7) 
driver can usurp a keyboard from hilkbd by changing it from mapped mode to raw mode. 

System Calls 

open(2) gives exclusive access to the keyboard. If there is an ite (internal terminal emulator) associated 
with the keyboard, the ite loses input from the keyboard until the keyboard device is closed. Any previous 
queued input for the keyboard device is flushed from the input queue. 

close(2) returns control of the keyboard to the ite, if present. Any unread input is discarded at that time, 
read(2) returns data from the keyboard in time-stamped packets: 

unsigned char time_stamp[4]; 
unsigned char status; 
unsigned char data; 

time_stamp, when repacked into an integer data type of four or more bytes, specifies the time si nee an arbi¬ 
trary point in the past (e.g., system start-up time). This point does not change between packets, but time 
during a power failure may or may not be counted. The time is in units of tens of milliseconds. 

The status byte encodes the state of the keyboard Shift and Ctrl keys: 

0x8X shift and control 
0x9X control only 
OxAX shift only 
OxBX no shift or control 

The data byte contains the actual keystroke. 

If the file status flag ON delay is set, read (2) returns 0 instead of blocking, when no data is available. The 
read(2) system call on an hp-hil keyboard is considered "slow"; that is, it can be interrupted by caught sig¬ 
nals (see signal (2)). 

write(2) is not supported by hilkbd. 

select(2) can be used to poll for input to read from hilkbd devices. select(2) for write or for exceptional con¬ 
ditions always returns a false indication in the bit masks. 

ioctl (2) is used to perform special operations on the device, ioctl (2) system calls have the form: 

int ioctl(int fildes, int request, char *arg); 

Thefollowing hilkbd request codes aredefined in <sys/hilioctl.h>: 

KBDREADCONFIG 

Read the configuration code. 

This request returns a one-byte configuration code in the char variableto which arg points. 
This contains a field, defined by kbd idcode mask, which specifies the keyboard 
identification code. The possible values of this field are defined in the header file, and this 
identification code affects interpretation of the language code. All other fields in the 
configuration code are currently undefined. 

KBD_READ_LANGUAGE 

Read the language code. 

This request returns a one-byte language code, as read from the keyboard, in the char 
variable to which arg points. If there is more than one keyboard, the language is taken 
from the first keyboard on the link. I nterpretation of the language code is affected by the 
keyboard identification field within the configuration code. 
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kbd status Read the keyboard status register. 

This request returns a one-byte value containing bit flags specifying the state of the shift 
and control keys in the char variableto which arg points: 

KBD STAT LEFTSHIFT The left shift key is up 
KBDSTATRIGHTSHI FT The right shift key is up 
KBD_STAT_SHIFT Both shift keys are up 

KBDSTATCTRL The control key is up 

Other bits are undefined. 

K B D_R E P E AT_RAT E 

Set the keyboard auto-repeat rate. 

The one-byte value to which arg points is the negative of the repeat period, in tens of mil¬ 
liseconds. The repeat rate is the reciprocal of the repeat period. A parameter of zero dis¬ 
ables auto-repeat. 

KBD_RE PEAT_DE LAY 

Set the keyboard auto-repeat delay. 

The one-byte value to which arg points is the negative of the repeat delay, in tens of mil¬ 
liseconds. 

kbd beep Cause an audible beep. 

The one-byte value to which arg points specifies the volume of the beep, within the range 0 
through KBD MAXVOLUME. Implementations with fewer than kbd maxvolume discrete 
levels of volume will scale the parameter into the smaller range. 

ERRORS 

[einval] An invalid parameter was detected by ioctl (2). 

[eintr] A signal was caught during a read(2) system call. 

[ENXIO] No keyboard is present on theHP-HiL link specified by the minor number. 

[enodev] An attempt was made to use write(2) using hilkbd. 

[ebusy] The device is already open. 

AUTHOR 

hilkbd was developed by the Flewlett-Packard Company. 

FILES 

/dev/hi I kbd* 

SEE ALSO 

termio(7), hi I (7), mknod(lM), select(2), signal (2). 
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NAME 

hpib- Hewlett-Packard I nterface Bus driver (OBSOLETED AT 10.30) 

SYNOPSIS 

#include <sys/hpibio.h> 

DESCRIPTION 

hp-ib is Hewlett-Packard's implementation of the I nstitute of Electrical and Electronic Engineers Standard 
Digital Interface for Programmable Instrumentation (IEEE Std 488-1978). This section describes the use of 
theHP-iB driver in theHP-ux system. 

Auto-addressed Files vs. Raw Bus Files 

A major distinction is made in the hp-ux driver between "auto-addressed" files and "raw bus" files. An 
auto-addressed file is associated with a specified address on the hp-ib. The user need not be concerned 
with any hp-ib addressing or commands; the driver handles device addressing and unaddressing during 
data transfers. However, the user is limited to transactions to and from a single device. A raw bus file, on 
the other hand, gives the user access to the entire HP-IB; responsibility for all commands and addressing 
lies with the user. The raw bus file is typically used to access multiple devices on the same bus, as well as 
provide universal device commands such as interface clear and parallel poll. 

Although differences exist between auto-addressed and raw bus files, the user/driver interface is consistent 
across both types. Therefore, each category of requests is presented with separate subsections for auto- 
addressed and raw bus files. 


Naming Convention 

hp-ib device files are named according to thefollowingformat: 

/dev/hpib/c #[t MO ] 

where c# specifies the card instance of the bus, t# specifies the HP-IB address on that bus, and dO 
specifies a device unit of zero. A device file specifying only the card instance denotes the raw bus. Files 
with the address suffix are auto-addressed. 


Devi ce Attr i butes 

hp-ib attributes are classified into two groups, per-open and per-interface. FiIe descriptors obtained from 
separate open() requests have separate per-open attributes (see open (2)); changing an attribute from the 
per-open group affects requests on that file descriptor only. Attributes in the per-interface group are 
shared by all file descriptors on that interface; changing an attribute from one file descriptor affects all 
users of the interface. 


The per-open set of attributes and the driver requests to change them are listed in the following table. All 
other attributes are per-interface. 


Attribute 

ti meout 

write termination mode 
read termination pattern 
read termination reason 
signal mask 
lock count 
wait events 


Driver Request 

HPIBTIMEOUT 

HPIB_EOI 

HPIBREADPATTERN 
HPIB_TERM_REASON 
HPIB SIGNAL MASK 
HPIB_LOCK 

HPIB WAIT ON STATUS 


Transfer Requests 

The standard read() and write () requests are used for data transfer over hp-ib (see read(2) and 
write(2)). However, their actions are slightly different for each type of file. Raw bus files place data 
directly onto the bus. No addressing or unaddressing of devices is done by the driver; this is the user's 
responsibility. 

On the other hand, the driver does all addressing for transactions with auto-addressed files. The actual 
sequence of events is: 

UNL, <da/iceaddressings-, <data>, <terminator> 

All write requests end when the specified number of bytes has been transferred over the bus. Optionally, 
the hp-ib END message can be sent with the last byte written; this is controlled via the HPIB_E0I 
request. All read requests end when the specified number of bytes has been read over the bus or when the 
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device asserts EOI. In addition, a single character can be designated to end the read operation via the 

HPIB_READ_PATTERN request. 

Control Requests 

Control requests cause some action on the bus. All such requests have the same format: 

struct io_ctl_status { 
int type; 
int arg [3]; 

} hpib_control; 

ioctl(fildes, IO_CONTROL, &hpib_control); 

In the io_ctl_status structure, the type field specifies the type of control function required, while 
the arg array holds any associated arguments. The defined values for type and their use are described 
as follows: 


HPIB_TIMEOUT 


HPIB__WIDTH 


HPIB_SPEED 


HPIB__EOI 


Set the timeout. If any transaction for this file takes longer than arg[0] 
microseconds, it is aborted with a status of etimedout returned to the user. This is 
used mainly for detecting device failure. A timeout of 0 is equivalent to infinity: that 
is, no transaction will timeout. 

Set the width of the interface. This request specifies the number of valid data lines on 
transfers; arg[0] holds the desired interface width in bits. All future read requests 
inspect only the least significant arg[0] data lines, and all future writes present 
data on only those lines. The state of all other data lines is indeterminate. 

Set the transfer speed of the interface. The desired data transfer speed in kilobytes 
per second is specified in arg [0] . Note that this value is advisory only, and is typi¬ 
cally used by the driver to determine the method of data transfer. 

Enable/disable eoi assertion on writes. If arg[0] is nonzero, all subsequent writes 
end with eoi asserted on the last byte transferred. A zero arg[0] disables eoi 
assertion. 


HPIB_SYSTEM_CTLR 

Make the interface system controller or non-system controller. If arg[0] is 
nonzero, the interface becomes the system controller. A zero in arg[0] sets the 
interface to non-system controller. This request is applicableto raw bus files only. 

HPIB_READ_PATTERN 

Enable or disable pattern matching on reads. If arg[0] is nonzero, all subsequent 
reads terminate when the pattern specified in arg[l] is encountered in the input 
stream. This termination condition is subject to all other termination conditions in 
effect for the file. Only the n least significant bits of the pattern are used in the 
match, where n is the interface's current width, set via HPIB_WIDTH . A zero 
arg[0] disables read pattern matching. 

HPIB_SIGNAL_MASK 

Define signaling events. This request allows the calling process to receive a signal 
when some event occurs on the hp-ib. The event or events are specified by computing 
the bitwise inclusive or of the values from the list below, and placing the mask in 
arg[0] . All of these events can be enabled on raw bus files, but only ST_SRQ and 
ST„PPOLL apply to auto-addressed files. 


ST_SRQ 

ST_PPOLL 

ST_REN 

STACTIVECTLR 

ST_TALK 

ST_LISTEN 

ST_IFC 

STDCL 


Signal on assertion of Service Request (SRQ). 
Signal when device responds to Parallel Poll. 
Signal when interface enters remote state. 
Signal when i nterface becomes active controller. 
Signal when interface is addressed to talk. 
Signal when interface is addressed to listen. 
Signal on assertion of I nterface Clear (IFC). 
Signal on receipt of Device Clear (DCL). 
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ST_GET Signal on receipt of Group Execute Trigger (GET). 

When any subsequent flagged event occurs, the process is sent SIGEMT. The user 
should set up a handler to trap this signal via signal () or sigvector () (see 
signal(2) or sigvector(2)). The reason for interrupt can be obtained via the 
lO_STATUS request HPIB_SIGNAL_MASK. Each request overwrites the previous 
mask for the file; therefore events can be disabled by using a zero arg [0]. 

If ST_PPOLL is flagged, the user supplies additional information in the arg array. 
For raw bus files, the low-order bytes of arg[l] and arg[2] contain eight-bit 
masks with each bit corresponding to a Data I/O (Dio) lineand the least significant bit 
mapped to dioi. When a device responds to parallel poll, it asserts the appropriate 
line; arg [1] 's bits indicate the parallel poll sense of this assertion. Bits set in 
arg [2] indicate that the corresponding address is capable of responding to polling. 
For auto-addressed files, arg[l] specifies the parallel poll sense of the assigned 
device's response to parallel poll. Parallel poll interrupts can be enabled only if the 
interface is the active controller. 

HPIB_LOCK Lock or unlock the HP-IB interface. Setting arg[0] to LOCK_INTERFACE locks 

the hp-ib interface, giving the calling process exclusive access to the card and bus. 
The lock is incremental; that is, if the interface is already locked by the current pro¬ 
cess, additional lock requests increment a per-open lock count maintained in the 
driver. 

An arg[0] of UNLOCK_INTERFACE decrements the per-open lock count; when 
the total interface lock count drops to zero, the lock is cleared. The lock can also be 
cleared by setting arg[0] to CLEAR_ALL_LOCKS, which removes all locks held by 
the current process. 

After a successful lock or unlock, arg[l] contains the current lock count for this 
open, and arg[2] contains the total lock count on this interface. 

While the interface is locked, other processes that attempt to access the bus or inter¬ 
face are blocked until either the interface becomes unlocked or the process's per-open 
timeout (set via HPlB__TlMEOUT ) expires. Flowever, if the 0__NDELAY file status 
flag is set (see fcntl(5)), the user request fails and returns immediately with the 
eacces error. See the Summary of Privilege Requirements section for a list of user 
requests that might block. 

HPIB_ADDRESS Set the HP-IB address to which the interface responds when it is not the active con¬ 
troller. The bus address is set via arg[0] , and must be between 0 and 30 decimal. 
Two additional flags, HP I B_TALK_ALWAY S and HPIB LISTEN ALWAYS, can be 
set by computing the bitwise inclusive or of their values with the address. These 
flags enable the interface to talk, and/or listen always, respectively. This request is 
applicableto raw bus files only. 

HPIB_RESET Reset the device or bus, depending on which of thefollowing values is in arg[0] : 

DEVICE_CLR Address the device and send a selective device clear (SDC) 

command. This applies only to auto-addressed files. 

BUS_CLR Assert Interface Clear (IFC) and Remote Enable (REN), 

and clear Attention (ATN). 

HW_CLR Reset bus interface card. The card is self-tested and if 

the card is system controller, IFC is pulsed. All other 
card state information is preserved. This applies to raw 
bus files only. 

HPIBPPOLLRESP 

Control the interface's response to parallel poll. When the interface is not acting as 
active controller, it can be enabled to respond to parallel polling by the current active 
controller. If arg[0] is nonzero, the interface responds to parallel poll. arg[l] 
specifies the Dio line on which the card responds; arg[l] has a value between 0 
and 7, with a value of 0 mapping to dioi, 1 mapping to DI02, and so forth. The 
parallel poll sense of the response is determined by arg[2] . An arg[0] of zero 
disables the interface's response to parallel poll. 
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For auto-addressed files, the file's associated device address is configured, rather than 
the interface. 

HPIB_PPOLL_IST 

Enable or disable response to parallel poll. If arg[0] is nonzero, the interface 
responds to parallel poll. An arg[0] of zero disables the interface's response. This 
differs from the previous request, because the parallel poll sense and address of the 
interface's response are unchanged. Thisrequest appliesto raw bus files only. 

HPIB_REN Place a device into or out of the remote state. For a raw bus file, this request merely 

sets or clears the Remote Enable line, depending on whether arg[0] is nonzero or zero 
respectively. For auto-addressed files, a nonzero arg[0] asserts the Remote Enable 
line and addresses the device. If arg[0] is zero, the device is removed from the remote 
state by sending it a Go-to-Local command (GTL). 

HPIB SRQ Request service. This request causes the interface to assert the Service Request line 

(SRQ) until it is serially polled. At that time it responds with the status byte given in 
arg[l] . Thisrequest appliesto raw bus files only. 

This request is normally used only when the interface is not the active controller. 
Nonetheless, the active controller can assert SRQ, and the HPIB__BUS_STATUS 
request will reflect the assertion; however, the srq line does not change state until 
the interface passes control. 

HPIB_P AS SCONTROL 

Pass active control of the bus. If the interface is currently active controller, this 
request relinquishes control of the bus, passing it instead to the device at the bus 
address in arg[0] . Passing control should be done with care, since it is not possible 
to detect whether the named device can indeed assume bus control. This request 
applies only to raw bus files. 

HPIB_GET_CONTROL 

Become active controller. This request causes the interface to assert Interface Clear 
(IFC) and Remote Enable (REN) as a means of regaining control of the hp-ib. It 
applies only to raw bus files. 

Transparent Bus Request 

This request allows a user to send direct commands over the FIP-IB; it should be used with care, since 
improper use might place the bus in an unusable state. 

The transparent bus request takes the foil owing form: 

struct hpib_command { 
int length; 

char buffer[MAX_HPIB_COMMANDS]; 

} hpib_cmd; 

ioctl (fildes, HPIB_COMMAND, &hpib_cmd); 

This call transmits length bytes of data in buffer over the hp-ib with Attention (ATN) asserted. On comple¬ 
tion of the request, atn remains asserted. 

For commands sent through an auto-addressed file, buffer is surrounded with the appropriate device 
addressing. What appears on the bus is: 

UNL, TALK CIC, LISTEN device, buffer 

This differs from the approach toward a raw bus file. For such files, the buffer is merely placed on the bus 
with atn asserted, with no addressing or unaddressing. 

Status Requests 

These requests are used to obtain information about the general state of a device or the hp-ib. Their cal¬ 
ling sequence is similar to that of control requests: 

struct io_ctl_status hpib_status; 
ioctl(fildes, IO_STATUS, &hpib_status); 

As with the data structure to control requests, the type field specifies the type of information requested, 
while the arg array holds clarification data. The defined status requests for hp-ib and their use are 


Section 7-46 


-4- 


HP-UX Release 11.0: October 1997 


h pi b (7) 


(Series 800 Only) 


hpib(7) 


described as follows: 

HPIB_ADDRESS Return the bus address associated with the file i n arg [ 0 ] . 

HPIB_TIMEOUT Return the interface's timeout in microseconds in arg[0] . 

HPIB_WIDTH Return the interface's path width in bits in arg [0] . 

HPIB_SPEED Return the interface's data transfer rate in K-bytes per second in arg[0]. 

HPIB_READ_PATTERN 

Return the interface's read termination pattern in arg [ 0 ] ; if pattern matching is not 
enabled, arg[0] holds a-1. 

HPIB_SIGNAL_MASK 

Return the reason for the last signal. This request returns a mask in arg[0] , with 
bits set indicating the reason(s) for the last SIGEMT sent to the user process. Bit 
definitions are identical to those of the corresponding I0_C0NTR0L request. 

HPIB_L0CK Return lock status. If the device is locked to a process, return that process id in 

arg[0] and the interface lock count in arg[l]. If the device is not locked, 
arg [0] holds a -1. 

HPIB_TERM_REASON 

Return end conditions for the last read from this device or bus. This request returns a 
bytein arg[0] , with a mask of reason(s) for thecompletion of the last read from the 
device or raw bus. Applicablebits are: 

TR COUNT Read requested number of bytes. 

TR_MATCH Detected specified match pattern. 

TR_TIME0UT Timed out. 

TR_END Devi ce asserted E oi. 

TR_ERROR Detected bus error. 

TR_NOTERM No read done since open. 

HPIB_PP0LL Conduct a parallel poll. This request returns the bus response to parallel poll in the 
least significant byte of arg[0] , with dioi corresponding to the least significant bit. 
The driver delays at least 100 microseconds before reading the poll response, thus 
allowing the use of HPlB_PPOLL on systems with extended buses. This request 
applies to both auto-addressed and raw bus files. 

HPIB_SP0LL Conduct a serial poll. For raw bus files, this request conducts a serial poll of the dev¬ 
ice address in arg[l]; the status byte returned by the device is available in 
arg[0] . Auto-addressed files ignore any address in arg[l] , polling instead the 
device's predefined address. 

HPIB_BUS_S TATUS 

Return the status of the HP-iB. This request, applicableto both types of files, returns 
information related to the current bus state. On return, arg[0] holds a value with 
bits set indicating: 

ST_NDAC ndac is being asserted. 

STSRQ SRQ is being asserted. 

ST_REN I nterface is in the remote state. 

ST ACTIVE CTLR I nterface is active controller. 

ST_SYSTEM_CTLR I nterface is system controller. 

ST_TALK I nterface is addressed to talk. 

ST_LISTEN I nterface is addressed to listen. 

ST_TALK_ALWAYS I nterface is configured to tal k always. 
ST_LISTEN_ALWAYS 

I nterface is configured to listen always. 
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HPIBWAIT_ON_PPOLL 

Wait (sleep) until a given device responds to parallel poll. This request blocks the user 
until either the user's device responds to parallel poll (for auto-addressed files) or until 
any enabled devices respond (for raw bus files). 

For a raw bus file, arg[l] and arg[2] contain eight-bit masks as defined in the 
HPI B_SIGNAL_MASK request. The return value of the request in arg[0] shows 
which devices responded to parallel poll. 

For an auto-addressed file, arg[l] specifies the sense of the particular device's 
assertion. Successful completion of the request implies that the device responded. 


HPIBWAITONSTATUS 

Wait (sleep) until any of a set of given states is entered. The event(s) to await are 
specified by computing the bitwise inclusive OR of the values from the list below, and 
placing the mask in arg [0] . Applicablebits are: 

ST_SRQ Wait until SRQ is asserted. 

ST ACTIVE CTLR Wait until user is active controller. 

ST_TALK Wait until user is addressed to talk. 


ST_LISTEN 


Wait until user is addressed to listen. 


Note that more than one bit can beset, thereby waiting for any of the events to occur. 
The return value in arg[0] is modified to show the actual event(s) that ended the 
wait. This is applicableto raw bus files only. 

HPIB_INTERFACE_TYPE 

Return the interface type. This returns one of two values in arg [0] : 
HPIB_INTERFACE The open file is a H p-i B raw bus file. 

HPIB DEVICE The open file is a HP-i B auto-addressed file. 


Extended Status Request 

If the user wants to obtain several status variables in one request, the foil owing request can be used: 
struct io_environment hpib_env; 
ioctl(fildes, IO_ENVIRONMENT, &hpib_env) ; 
where the io_environment structure includes thefollowingfields: 

int interface_type; 

int timeout; 

int status; 

int term_reason; 

int read_pattern; 

int signal_mask; 

int width; 

int speed; 

int locking_pid; 

Summary of Privilege Requirements 

The following table summarizes which ioctl () requests can be performed under what circumstances 
(see ioctl (2)). The first three columns indicate whether the interface must be in the controlling state given 
to perform the request. An entry of Y means that the interface must be in that state, N means that the 
interface must not be in that state, and - means that the state is irrelevant. The next two columns indicate 
whether the request works for auto-addressed or raw bus files. The final column indicates whether the 
request is subject to blocking whilethe interface is locked (seeHPlB_LOCK). 

If an entry is marked with an asterisk (*), check the particular request for more information. 
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Non- 

Active 

System 

Auto 

Raw 

Lock 

Request 

Ctlr 

Ctlr 

Ctlr 

Addr 

Bus 

E nforced 

I0_C0NTR0L 







HPIBTIMEOUT 

- 

- 

- 

Y 

Y 

N 

HPIBWIDTH 

- 

- 

- 

Y 

Y 

Y 

HPIBSPEED 

- 

- 

- 

N 

Y 

Y 

HPIBEOI 

- 

- 

- 

Y 

Y 

N 

HPIB_SYSTEM_CTLR 

- 

- 

- 

N 

Y 

Y 

HPIB_READ_PATTERN 

- 

- 

- 

Y 

Y 

N 

HPIBSIGNAL_MASK 

* 

* 

- 

Y 

Y 

Y 

HPIBLOCK 

- 

- 

- 

Y 

Y 

Y 

HPIB_ADDRES S 

- 

- 

- 

N 

Y 

Y 

HPIB_RESET 







DEVICECLR 

N 

Y 

- 

Y 

N 

Y 

BUS_CLR 

- 

- 

Y 

Y 

Y 

Y 

HWCLR 

- 

- 

- 

N 

Y 

Y 

HPIB_PPOLL_RESP 

N 

Y 

- 

Y 

Y 

Y 

HPIBPPOLLIST 

- 

- 

- 

N 

Y 

Y 

HPIB_REN 

- 

- 

Y 

Y 

Y 

Y 

HPIBSRQ 

- 

* 

- 

N 

Y 

Y 

HPIB_PASS_CONTROL 

N 

Y 

- 

N 

Y 

Y 

HPIB_GET_CONTROL 

- 

- 

Y 

N 

Y 

Y 

HPIB_COMMAND 

N 

Y 

- 

Y 

Y 

Y 

IO_STATUS 







HPIB_ADDRE S S 

- 

- 

- 

Y 

Y 

Y 

HPIBTIMEOUT 

- 

- 

- 

Y 

Y 

N 

HPIBWIDTH 

- 

- 

- 

Y 

Y 

N 

HPIBSPEED 

- 

- 

- 

Y 

Y 

N 

HPIB_READ_PATTERN 

- 

- 

- 

Y 

Y 

N 

HPIB_SIGNAL_MASK 

- 

- 

- 

Y 

Y 

N 

HPIBLOCK 

- 

- 

- 

Y 

Y 

N 

HPIB_TERM_REASON 

- 

- 

- 

Y 

Y 

N 

HPIBPPOLL 

N 

Y 

- 

Y 

Y 

Y 

HPIBSPOLL 

N 

Y 

- 

Y 

Y 

Y 

HPIB_BUS_STATUS 

- 

- 

- 

Y 

Y 

Y 

HPIB_WAIT_ON_PPOLL 

N 

Y 

- 

Y 

Y 

Y 

HPIB_WAITONSTATUS 

- 

- 

- 

N 

Y 

Y 

HPIB_INTERFACE_TYPE 

- 

- 

- 

Y 

Y 

N 

IO_ENVIRONMENT 

- 

- 

- 

Y 

Y 

Y 


Default Configuration 

The default configuration of any hp-ib file is: 
Timeout Infinite 

Path Width 8 bits 


Transfer Speed 
EOI 

Pattern Match 
Enabled Signals 
Locking 


0 

Assertion Enabled 
Disabled 
None 
Unlocked 


Termination Reason TR_NOTERM 


ERRORS 

A -1 return valuefor a driver request indicates that an error occurred; errno is set to specify the reason. 
In addition to errors defined in open(2), dose(2), read(2), write(2), and ioctl (2), a driver request can fail if 
any of the foil owing conditions are encountered: 

[EACCES] The interface is not in the active-controller or system-controller state. 
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[EACCES] The interface is currently locked by another process via HPIB_L0CK. 

[EACCES] A request to access the file would block and the 0_NDELAY file status flag is set for 
the file descriptor. 

[einval] The request is not applicable to this type of file. Alternatively, type or arg has an 
invalid value. 

[eintr] An interface power failure occurred during the processing of this request; the device 

might have lost state. 

[eintr] A signal was received either while waiting for the interface to become unlocked, or 

while waiting for a HPIB WAIT_ON PPOLL or HPIB WAI T_ON_S TATUS 
request. 

[ElO] An unclassified error occurred. 

[EMfile] The number of simultaneous open() requests on this interface exceeds the max¬ 
imum allowed. 

[enxio] No bus interface is associated with the device file. 

[eperm] An attempt was made to unlock an interface that was not locked. 

[Erange] The interface lock count was exceeded. 

[etimedout] The transaction did not complete within the timeout specified. 


WARNINGS 

It is possible to circumvent the bus protection mechanisms afforded by the auto-addressed and raw bus 
dichotomy. Specifically, a user of an auto-addressed file can send commands to any or all devices on the 
bus with the HPIB_C0MMAND request, if the proper device addressingisdonewithinthedata buffer. 

The HPIB LOCK request should be used with care. Since it provides an exclusive lock, invoking the 
HPIB LOCK blocks access to any system disk or swap device on the associated bus. 

Processes that use HPIB_L0CK should clear all locks before exiting. The driver attempts to clear them if 
the process terminates unexpectedly; however, a lock might be left outstanding if the locker dies after 
creating new file descriptors (via fork() or dup() that refer to the same device file (see fork(2) or 
dup(2)). Ensuring that all open file descriptors on a given interface are closed remedies the situation. 

By default, some hp-ib peripherals respond to parallel poll on Dl On, where n has the value of 8 minus the 
device's bus address. That is, a device at address 6 can respond on DI02. Therefore, the results of an 
HPIB PPOLL request can be misleading if some devices are not remotely configured. 

It is impossibleto transfer data using a secondary address in a singledriver request. 


DEPENDENCIES 
HP 27110B 

The HPIB SPEED and HPIB_SYSTEM_CTLR requests are not supported; they are configured by 
switches on the device adapter. 

The HPIB SRQ request can affect only the RQS bit of the serial poll response byte; all other bits are 
masked to zero by the hardware. 


AUTHOR 

hpib was developed by HP. 

FILES 

/dev/hpib/* 

SEE ALSO 

fcntl(5), ioctl(2), signal(2), sigvector(2), specific device documentation in section 7. 
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NAME 

inet - Internet protocol family 

SYNOPSIS 

#include <sys/types.h> 

#include <netinet/in.h> 

DESCRIPTION 

The internet protocol family is a collection of protocols layered on top of the Internet Protocol (IP) net¬ 
work layer, which utilizes the internet address format. The internet family supports the SOCKSTREAM 
and SOCKDGRAM socket types. 

Addressing 

Internet addresses are four byte entities. The include file <netinet/in .h > defines this address as the 
structure struct in_addr. 

Sockets bound to the internet protocol family utilize an addressing structure called struct 
sockaddr_in . Pointers to this structure can be used in system calls wherever they ask for a pointer to a 
struct sockaddr. 

There are three fields of interest within this structure. The first is sin_family , which must be set to 
AFJNET. The next is sin_port, which specifies the port number to be used on the desired host. The 
third is sin_addr , which is of type struct in_addr , and specifies the address of the desired host. 

Protocols 

The internet protocol family is comprised of the ip network protocol, Internet Control Message Protocol 
(ICMP), Transmission Control Protocol (TCP), and User Datagram Protocol (UDP). tcp is used to support the 
SOCK_STREAM socket type while udp is used to support the SOCK_DGRAM socket type. TheiCMP mes¬ 
sage protocol and ip network protocol are not directly accessible. 

The local port address is selected from independent domains for TCP and udp sockets. This means that 
creating a TCP socket and binding it to local port number 10000, for example, does not interfere with creat¬ 
ing a udp socket and also binding it to local port number 10000at thesametime. 

Port numbers in the range 1-1023 inclusive are reserved for use by the super-user only. Attempts to bind 
to port numbers in this range by non-super-users fail and result in an error returned. 

AUTHOR 

inet was developed by the University of California, Berkeley. 

SEE ALSO 

tcp(7P), udp(7P). 


HP-UX Release 11.0: October 1997 


1- 


Section 7-51 


iomap(7) 


iomap(7) 


NAME 

iomap - physical I/O address mapping 

SYNOPSIS 

#include <sys/iomap.h> 

DESCRIPTION 

The iomap mechanism allows the mapping (thus direct access) of physical I/O addresses into the user pro¬ 
cess address space. For PA-RISC machines, the physical I/O address space begins at Oxf0000000 and 
extends to Oxf f f f f f f f. 

The special (device) files for iomap devices are character special files using the dynamic major number 
allocation scheme. 

The minor number for iomap devices is of theform: 

OxAAAASM 

The physical I/O address is formed by prefixing OxAAAA with OxF, and by appending 0x000 (this forces the 
I/O address to be page-aligned). The size of the region to be mapped is given by the expression M*(2“S) 4K 
pages. For example, the minor number for a device starting at 0xf4000000 that occupies 64MB is 
0x4000el. 

The iomap driver must be explicitly added to the /stand/system file, the kernel rebuilt, and the sys¬ 
tem subsequently rebooted prior to first using iomap. 

I/O space is always mapped with both read and write access rights, regardless of the actual permissions on 
the device special file. 

Multiple processes can have concurrently a singleiomap device opened and mapped. It is the responsibil¬ 
ity of the processes to synchronize their access. 

Successive calls to iomap to map the same I/O space must be identical to the first mapping. Identical 
mappings have the same address and size. 

Note that a process can additionally share I/O space (mapped by iomap) with a kernel driver. Flowever, 
this is only possible if the driver maps in the I/O space with user read/write access rights using the 
appropriate driver I/O mapping services. Any I/O space mapped by drivers with kernel read/write access 
rights cannot be concurrently mapped by processes using iomap. 

Noreadf) orwrite() system calls are supported by the iomap driver. 

The ioctl () function is used to control the iomap device. The following ioctl () requests are defined 
i n <iomap. h >: 

IOMAPMAP Map the iomap device into user address space at the location specified by the 

pointer to which the (void **) third argument to ioctl () points. If the 
argument points to a variable containing a null pointer, the system selects an 
appropriate address, ioctl () then returns the user address where the device 
was mapped, storing it at the address pointed to by the third argument (see 
examples below). Multiple processes can concurrently have the same iomap 
device mapped. 

IOMAP UNMAP U nmap the iomap device from the user address space. 

close() shuts down the file descriptor associated with the iomap device. If the close is for the last sys¬ 
tem wide open on the device, the iomap device is also unmapped from the user address space; otherwise it 
is left mapped into the user address space (see IOMAPUNMAP above). 

WARNING 

Be extremely careful when creating and using iomap devices. Inappropriate accesses to I/O devices or 
ram can result in a system crash. 

ERRORS 

[einval] The address field was out of range, or the ioctl request was invalid. 

[enomem] Not enough memory could be allocated for themapping. 

[ebusy] Device was already mapped and this mapping was not identical to the initial mapping 

(same address, size and access rights). 
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[ENODEV] 

[ENXIO] 

[ENOSPC] 

[ENOTTY] 


EXAMPLES 

Consider the foil owing code fragment: 

#include <sys/iomap.h> 

int fildes; 
void *addr; 

addr = REQUESTED__ADDRESS; 

(void) ioctl(fildes, IOMAPMAP, &addr); 

(void) printf("actual address = Ox%x\n", addr); 

where fildes is an open file descriptor for the device special file and REQUESTED_ADDRESS is the 
address originally requested by the program. 

If addr is a null pointer, the system selects a suitable address then returns the selected address in addr. 

If the value in addr is not a null pointer, it is used as a specified address for allocating memory. If the 
specified address cannot be used, an error is returned (see errors). 

SEE ALSO 

mknod(lM). 


iomap(7) 

Read and write calls are unsupported. 

No such device at the address specified by the minor number. 

Required resources for mapping could not be allocated. 

Inappropriate ioctl request for this device type; fildes is not a file descriptor for an 
iomap device file. 
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NAME 

IP - Internet Protocol 

SYNOPSIS 

#include <sys/socket.h> 

#include <netinet/in.h> 

s = socket(AF_INET, SOCK„DGRAM, 0); 

DESCRIPTION 

IP is the network-layer protocol used by the I nternet protocol family. It encapsulates TCP and UDP mes¬ 
sages into datagrams to be transmitted by the network interface. Normally, applications do not need to 
interface directly to I P. However, certain multicast socket options are controlled by passing options to the 
IPPROTO IP protocol level through a UDP socket, and IP Type of Service is controlled by passing an 
option to the IPPR0T0_IP protocol level through either a TCP or UDP socket. (See the getsockopt(2) 
manual page.) 

The following socket options are defined in the include file <netinet/in .h >. The type of the variable 
pointed to by the optval parameter is indicated in parentheses. The data types struct ip_mreq and 
struct in_addr are defined in <netinet/in.h >. 

IP TOS (unsigned char) Sets the IP Type of Service. Allowable values for 

optval are4for high reliability, 8 for high throughput, and 16 for low delay. 
Other values will not return an error, but may have unpredictable results. 
Default: zero. 

IP_ADD_MEMBERSHIP (struct ip_mreq) Requests that the system join a multicast group. 

IP_DROP_MEMBERSHIP 

(struct ip_mreq) Allows the system to leave a multicast group. 

IPMULTICASTIF (struct in_addr) Specifies a network interface other than the default 
to be used when sending multicast datagrams through this socket. Default: 
multicast datagrams are sent from the interface associated with the specific 
multicast group, with the default multicast route or with the default route. 

IPMULTICASTLOOP (unsigned char; boolean) Enables or disables loopback in the IP layer 
for multicast datagrams sent through this socket. The value of the variable 
pointed to by optval is zero (disable) or non-zero (enable). This option is 
provided for compatibility only. Normally, multicast datagrams are always 
looped back if the system has joined the group. See DEPENDENCIES 
below. Default: enabled. 

I P_MUL TI CAS T_T T L (unsigned char) Specifies the time-to-live value for multicast datagrams 
sent through this socket. The value of the variablepointed to by optval can 
be zero through 255. Default: one. 

IP_ADD_MEMBERSHIP requests that the system join a multicast group on the specified interface. For 
example: 

struct ip_mreq mreq; 

mreq.imr_multiaddr.s_addr = net_addr("224.1.2.3"); 

mreq.imr_interface.s_addr = INADDR_ANY; 

setsockopt(s, IPPROTO_IP, IP_ADD_MEMBERSHIP, &mreq, sizeof(mreq)); 

A system must join a group on an interface in order to receive multicast datagrams sent on the network to 
which that interface connects. If imr_interface is set to I NADDR_ANY, the system joins the specified 
group on the interface that datagrams for that group would be sent from, based the routing configuration. 
Otherwise, imr_interface should be the IP address of a local interface. An application can join up to 
I P_MAX_MEMBERSHI PS multicast groups on each socket. IP_MAX_MEMBERSHIPS is defined in 
<netinet/in .h >. However, each network interface may impose a smaller system-wide limit because of 
interface resource I imitations and because the system uses some link-layer multicast addresses. 

The application must also bind to the destination port number in order to receive datagrams that are sent 
to that port number. If the application binds to the address I NADDR_ANY, it may receive all datagrams 
that are sent to the port number. If the application binds to a multicast group address, it may receive only 
datagrams sent to that group and port number. It is not necessary to join a multicast group in order to 
send datagrams to it. 
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IP_DR0P__MEMBERSHIP allows the system to leave a multicast group. For example: 
struct ip_mreq mreq; 

mreq.imr_multiaddr.s_addr = net_addr("224.1.2.3"); 
mreq.imr_interface.s_addr = INADDR ANY; 

setsockopt(s, IPPROTO_IP, IP_DROP_MEMBERSHIP, Smreq, sizeof(mreq)); 

The system remains a member of the multicast group until the last socket that joined the group is closed or 
has dropped membership in the group. 

IP MULTICAST IF specifies a local network interface to be used when sending multicast datagrams 
through this socket. For example: 

#include <arpa/inet.h> 
struct in_addr addr; 

addr.s_addr = inet_addr("192.1.2.3"); 

setsockopt(s, IPPROTOIP, IP_MULTICAST_IF, Saddr, sizeof(addr)) ; 

Normally, applications do not need to specify the interface. By default, multicast datagrams are sent from 
the interface specified by the routing configuration, namely the interface associated with the specific multi¬ 
cast group, with the default multicast route or with the default route. If addr is set to the address 
I NADDR_ANY, the default interface is selected. Otherwise, addr should be the I P address of a local inter¬ 
face. 

IP MULTICAST LOOP enables or disables loopback for multicast datagrams sent through this socket. 
For example: 

unsigned char loop = 1; 

setsockopt(s, IPPROTOIP, IP_MULTICAST_LOOP, Sloop, sizeof(loop)); 

Note that the type of the optval parameter is unsigned char instead of int, which is common for 
boolean socket options. This option is provided for compatibility only. Normally, if a multicast datagram is 
sent to a group that the system has joined, a copy of the datagram is always looped back and delivered to 
any applications that are bound to the destination port. See DEPENDENCI ES below. 

IP MULTICAST TTL controls the scope a multicast by setting the time-to-live value for multicast 
datagrams sent through this socket. For example: 

unsigned char ttl = 64; 

setsockopt(s, IPPROTOIP, IP_MULTICAST_TTL, Sttl, sizeof(ttl)); 

Note that the type of optval parameter is unsigned char instead int, which is common for socket 
options. By default, the time-to-live field (TTL) is one, which limits the multicast to the local network. If 
theTTL is zero, the multicast is limited to the local system (loopback). If theTTL is two, the multicast can 
be forwarded through at most one gateway; and so forth. Multicast datagrams can be forwarded to other 
networks only if there are special multicast routers on the local and intermediate networks. 

DEPENDENCIES 

The behavior of IP_MULTICAST_L00P depends on the network driver and interface card. Normally, 
loopback cannot be disabled, even if IP_MULTICAST_L00P is set to zero, because it occurs in the driver 
or in the network interface. Flowever, if the outbound interface is loO (127.0.0.1), or if 
IP MULTICAST TTL is set to zero, setting IP_MULTICAST_L00P to zero will disable loopback for 
multicast datagrams sent through the socket. 


DIAGNOSTICS 

One of the foil owing errors may be returned if a call to setsockopt () or getsockopt () fails. 


[EADDRINUSE] 
[EADDRNOTAVAI L] 

[EINVAL] 

[ENOBUFS] 


The specified multicast group has been joined already on socket. 

The specified IP address is not a local interface address; or there is no route 
for the specified multicast address; or the specified multicast group has not 
been joined. 

The parameter lei/el is not IPPR0T0_IP ; or optval is the NULL address; 
or the specified multicast address is not valid. 

I nsufficient memory is availablefor internal system data structures. 


[ENOPROTOOPT] The parameter optname is not a valid socket option for the IPPR0T0_IP 

level. 
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[EOPNOTSUPP] The socket type is not SOCK_DGRAM. 

[ETOOMANYREFS] An attempt to join more than I P_MAX_MEMBERSFII PS multicast groups 
on a socket. 


AUTHOR 

The socket interfaces to IP were developed by the University of California, Berkeley. M ulticast extensions 
were developed by the Stanford University. 

SEE ALSO 

bind(2), getsockopt(2), recv(2), send(2), socket(2), ipMcastLoop(lM), inet(7F), 
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NAME 

kmem - perform I/O on kernel memory based on symbol name. 

SYNOPSIS 

#include <sys/ksym.h> 

int ioctl (int kmemfd, int command, void *rks) ; 

DESCRIPTION 

When used with a valid file descriptor for /dev/kmem (kmemfd), ioctl can be used to manipulate ker¬ 
nel memory. The specifics of this manipulation depend on the command given as follows: 

MIOC_READKSYM 

Read mirkjouflen bytes of kernel memory starting at the address for mirk_symname into 
mirk_buf. rks is a pointer to a mioc_rksym structure, defined below. 

MIOC_IREADKSYM 

Indirect read. Read sizeof (void *) bytes of kernel memory starting at the address for 
mirk_symname and use that as the address from which to read mirk_buflen bytes of kernel 
memory into mirkbuf. rks is a pointer to a mioc_rksym structure. 

MIOCWRITEKSYM 

Write mirk_buflen bytes from mirk_buf into kernel memory starting at the address for 
mirk_symname. rks is a pointer to a mioc_rksym structure. 

MIOC IWRITERSYM 

Indirect write. Read sizeof (void *) bytes of kernel memory starting at the address for 
mirk_symname and use that as the kernel memory address into which mirk_buflen bytes from 
mirk buf are written, rks is a pointer to a mioc_rksym structure. 

MIOCLOCKSYM 

I ncrease the hold count by one for the dynamically loaded module whose name is given by rks, a 
pointer to a character string, thereby preventing its unloading. 

MIOCUNLOCKSYM 

Decrease the hold count by one for the dynamically loaded module whose name is given by rks, a 
pointer to a character string. If the count is thereby reduced to 0, the module becomes a candi¬ 
date for unloading. 

The struct mioc_rksym definition is: 

struct mioc_rksym { 

char * mirk_modname; 


char * mirk_symname; 


void * mirk_buf; 
size_t mirk_buflen; 


/* limit search for symname 
to module modname; if NULL 
use standard search order */ 
/* name of symbol whose address 
is the basis for this 
operation */ 

/* buffer into/from which 
read/write takes place */ 

/* length (in bytes) of desired 
operation */ 


RETURN VALUE 

ioctl returns 0 upon successful completion. If an error occurs, a value of -1 is returned and errno is 
set to indicate the error. 


ERRORS 

In addition to the errors described in ioctl (2), the kmem ioctl also fails if one or more of the foil owing are 
true: 


[EINVAL] 

[ENXIO] 

[EBADF] 


modname does not represent a currently loaded module or this is an 
MIOC UNLOCKSYM and the hold count is already 0. 

kmemfd open on wrong minor device (i.e., not /dev/kmem). 
kmemfd open for reading and this is an MI0C_WRITEKSYM. 
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[ENOMATCH] symname not found. 

[ENAMETOOLONG] modname is greater than MODMAXNAMELEN characters long, or symname is 
greater that MAXSYMNMLEN characters long. 

SEE ALSO 

getksym(2), ioctl (2), ioctl(5). 
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NAME 

Ian - network I/O card access information 

DESCRIPTION 

This manual entry gives a brief description on how to access the LAN device driver at Layer 2 (Data Link 
Layer) of the OSI architecture. The LAN device driver controls the various LAN interface cards (e.g, 
Ethernet/I EEE 802.3, FDDI, Token Ring) at Layer 1 (Physical Layer). 

The Data Link Provider Interface (DLPI) is the supported method for accessing the LAN device driver at 
Layer 2. DLPI is intended for use by knowledgeable network users only. Refer to the DLPI Programmer's 
Guidefor complete programming details. 

There are HP and non-HP drivers and interface cards which will provide their own DLPI module. These 
types of DLPI are referred to as "native" DLPI. 

Overview 

The Physical Point of Attachment (PPA) is a numerical value that uniquely identifies a particular device. 
The PPA value can be obtained from the lanscan command. The "NamePPA" identifier inthelanscan 
output is a concatenation of the interface name and the PPA number. The card instance value for a 
Ian device is equivalent to the PPA number for that device. 

A single hardware device may have multiple "NamePPA" identifiers, which indicates multiple encapsulation 
methods supported for to the device. For Ethernet/I EEE 802.3 links, the "Name" lan is used to designate 
Ethernet encapsulation, and snap for IEEE 802.3 encapsulation. For other links (FDDI, Token Ring), 
only the lan encapsulation designation is used. 

Methods of transfer over the DLPI interface through the lan devices include "raw", "connectionless", and 
"connection-oriented" data transfers. 

WARNING 

The Link Level Access (LLA) interface is obsolete. 

AUTHOR 

lan was developed by HP. 

SEE ALSO 

lanscan(lM), lanadmin(lM), linkloop(lM). 

DLPI Programmer's Guide, 1995, Hewlett-Packard 

The Ethernet, A LAN: Data Link Layer and Physical Specification, Version 2.0, November 1982, Digital 
Equipment Corporation, Intel Corporation, Xerox Corporation 

CSMA/CD Access Method and Physical Layer Specification, 1996, Institute of Electrical and Electronic 
Engineers 

Demand-Priority Access Method, Physical Layer & Repeater Specifications, 1996, Instituteof Electrical and 
Electronic Engineers 

Fiber Distributed Data Interface(FDDI) Physical Layer Medium Dependent (PMD), 1995, ANSI 

Token Ring Access Method and Physical Layer Specification, 1995, Instituteof Electrical and Electronic 
Engineers 

802.3u Media Access Control Parameters, Physical Layer, Medium Attachment Units, and Repeater for 100 
Mb/s Operation, Type 100BASE-T, 1995,1 nstituteof Electrical and Electronic Engineers 
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NAME 

Idterm - standard STREAMS terminal linedisciplinemodule 


SYNOPSIS 

#include 

#include 

#include 

#include 

#include 

#include 

#include 


<sys/stream.h> 
<sys/stropts.h> 
<sys/termios.h> 
<sys/bsdtty.h> 
<sys/ttold.h> 
<sys/strtio.h> 
<sys/eucioctl.h> 


int ioctl( fd, I_PUSH, "Idterm"); 


DESCRIPTION 

Idterm is a STREAMS module that supplies the line discipline for streams-based terminal or pseudo¬ 
terminal device drivers. This module provides most of the functions of the general terminal interface 
described in termio(7). However, it does not perform the low-level device control functions specified by the 
c_cflag word defined by the POSIX termios structure or the System V termio structure (defined 
in termios.h and termio.h, respectively). Also, some operations require the cooperation of the 
modules and drivers pushed below the Idterm module in a tty or pty (slave) stream. This man page only 
covers Idterm specific interface here and refers to the readers to termio(7) for the detail terminal inter¬ 
face. 

Internally, the Idterm module uses the Extended UNIX Code (EUC) character encoding scheme. This 
encoding scheme enables the Idterm module to process multibyte characters as well as simple 8-bit char¬ 
acters. It correctly handles backspacing, word erasing, and tab expansion for multibyteEUC characters. 

The Idterm module provides standard terminal operation consistent with the behavior specified by 
POSIX 1003.1 and System V Interface Definition (SVID) Third Edition. It also provides compatibility with 
the behavior of the BSD 4.3 line discipline. Notice that on other STREAMS systems, the BSD 4.3 compati¬ 
bility feature is usually provided by a separate STREAMS module called ttcompat . Hence, applications 
on HP-UX need not push ttcompat on top of Idterm to get BSD 4.3 compatibility. In fact, the 
ttcompat module is not provided on the HP-UX system at all. 

The Idterm module normally sits above either a STREAMS tty driver or a STREAMS pty slave driver. 
The user issues an STREAMS I_PUSH ioctl (2) system call to push Idterm onto the stream once the 
STREAMS tty or STREAMS pty slave device is opened. 

STREAMS Messages 

The Idterm module processes various types of STREAMS messages. The linedisciplinewill acton any of 
the following message types. Any others that the module receives, however, are passed onto the next 
module on the stream. 


Read-side Behavior 

Idterm processes thefollowing STREAMS messages on its input stream: 

M_FLUSH 

If FLUSHR is set, the read put routine flushes the read queue, discards characters in the input 
message buffers, and discards any partially buffered multibyte EUC characters. Then, it for¬ 
wards the message upstream. 

M_BREAK 

The read put routine processes the message according to POSIX rules for processing BREAK 
events, parity errors, and framing errors and signal generation (see termio(7) for detail). If 
there is no data in the message, the message is assumed to represent an input BREAK event, 
which is represented by a framing error with a character valueof 0 (zero). If there is data in the 
message, the data value is an integer that indicates the occurrence of an input BREAK event, or 
a character received with a parity or framing error. The low-order 8 bits of the data value is the 
byte that was read. If the TTY_PE flag is set in the higher-order bits of this integer, then a 
parity error was detected. If the TTY_FE flag is set in the higher-order bits of this integer, a 
framing error was detected. 

After reading the data value, the read put routine discards the message. 
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M_DATA The read put routine processes the message according to the POSIX 1003.1 specification, using 
multibyte processing for backspacing, word erasing, and tab expansion as appropriate. 

It generates echo characters and places them in the output buffer to be sent downstream to the 
write queue. While processing incoming data, it scans for START and STOP characters and 
sends M_START, M STOP messages downstream to the write queue, if needed. 

If the total number of buffered input characters is more than the high-water mark and IXOFF 
is set, the read put routine sends an M_STOPl message downstream. When the queue reduces 
its backlog below the low water mark, it sends an M_STARTI message downstream. 

If the number of buffered input characters reaches MAX_INPUT , and the IMAXBEL flag is set, 
the read put routine discards new input characters and sends a BEL character (Ctrl-G) down¬ 
stream. If IMAXBEL is not set, it flushes the input queue. 

If the ISIG flag is set, the read put routine sends M_PCSIG messages upstream when the 
appropriate signal characters are encountered. Then it discards the characters. 

If a character matching c_cc [VDISCARD] is encountered, and the IEXTEN flag is set, the 
read put routine sends an M_FLUSH (FLUSHW) message upstream to flush all write queues. 
The M_FLUSH message is reflected by the stream head and sent downstream through all the 
write queues. 

If the character signifies the logical termination of input, the read put routine sends the 
currently buffered characters upstream to the stream head. 

Logical termination of input depends on the state of the ICANON flag. If ICANON is set, the 
ldterm module is in canonical input mode. In that case, the read put routine logically ter¬ 
minates input at the end of a line of input. Canonical line termination characters are NEWLINE, 
EOF, EOL, and EOL2. If ICANON is dear, the ldterm discipline module is in noncanonical 
or raw input mode. In that case, the read put routine terminates input when at least VMIN 
bytes are present in the input message buffer or the timer specified by VTIME expires (see ter- 
mio(7) for more details). 

MIOCACK 

If the message acknowledges the POSIX termios TCGETS command, the read put routine 
copies the c_cflag and speeds information, which is sent by the console driver downstream, 
from the message into the internal POSIX termios structure. Then it copies the internal 
POSIX termios structure into the message. 

If the message acknowledges one of the POSIX termios set commands (i.e. TCSETS, 
TCSETSW, and TCSETSF) the read put routine copies all of the data from the message into the 
internal POSIX termios structure. 

After this processing is done, the read put routine determines if the I/O control command was 
originally a BSD 4.3 or System V I/O control command that was converted to a POSIX ter¬ 
mios command by the write service routine. If so, it restores the original data so that the mes¬ 
sage acknowledges the original I/O control command. Then it forwards the message upstream. 

M_CTL This message was sent by the driver to make special requests to ldterm. The structure of 
M_CTL messages is the same as that of M_lOCTL messages. The M_CTL message block 
points to a message buffer containing an iocblk data structure (defined in 
<sys/stream.h>). The ioc_cmd member of this structure contains a command, just as it 
does in an M_lOCTL message. The b_cont member of the M_CTL message block contains a 
pointer to an M_DATA message block, which contains data associated with the M_CTL mes¬ 
sage. 

The read put routine processes M_CTL messages containingthefollowing commands: 

MCNOCANON 

Turn off input processing normally performed on upstream M_DATA messages. This is for 
the use of modules or drivers that perform their own input processing such as pseudo¬ 
terminal (see ptm(7) and pts(7) ) in REMOTE mode connected to a program that performs 
the input processing. 

MC_D OCAN ON 

Turn on input processing normally performed on upstream M_DATA messages. This mes¬ 
sage is sent when the driver want ldterm to exit the REMOTE mode. 
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Write-side Behavior 

ldterm processes the following STREAMS messages on its output stream. Messages not listed here are 
simply forwarded downstream. 

M_FLUSH 

The write put routine flushes the write queue and discards any buffered output data. Then, it 
forwards the message downstream. 

M_DATA The write service routine processes the data according to the POSIX 1003.1 specification output 
flags. It sends the processed characters downstream to the driver when the output queue fillsup 
and all of the data is processed. 

MIOCTL 

The write put routine validates the format of the M_I0CTL message and checks for known 
commands. If the message format is invalid, it turns the M_lOCTL message into an 
M IOCNAK message, and returns the message upstream. If the I/O control command is not 
recognized, it forwards the M_lOCTL message downstream for processing by other modules. 

The write put routine determines if the command is one that must be processed in the proper 
sequence relative to M_DATA messages. If so, it queues the M_lOCTL message to the write 
queue for later processing by the write service routine. Commands that require processing in 
sequence are: 

TCSETSW,TCSETSF,TCSETAW,TCSETAF, TCSBRK 

Otherwise, the module's write put routine processes the command immediately. Detailed 
descriptions of the preceding ioctl commands are provided in the "ioctl Commands" subsec¬ 
tion, below. 

M_READ This message is sent by the stream head to notify downstream modules when an application has 
issued a read request and there is not enough data queued at the stream head to satisfy the 
request. The M_READ is sent downstream normally when ldterm is operating in non- 
canonical input mode. If VTIME is positive, the write put routine starts an input timer. When 
the timer expires, it sends all buffered input upstream. Then, it forwards the M_READ message 
downstream. 

ioctl Commands 

The ldterm module acts on two categories of ioctl commands: 

• Primary terminal I/O control commands 

• BSD 4.3 compatibility terminal I/O control commands 

Detail descriptions on how to use these ioctls can be found on the termio(7) man page. Note: the 
FIO[xyz] ioctls documented on termio(7) arecurrently not supported on ldterm. 

Primary Terminal I/O Control Commands 

The ldterm moduleactson thefollowing primary terminal I/O commands: 

TCSETS, TCSETSW, TCSETSF 

When the ldterm module receives any of these commands in an M_I0CTL message, it for¬ 
wards them downstream. When it receives the M_lOCACK message in the read queue, it copies 
the POSIX termios information from the message into the internal POSIX termios struc¬ 
ture and forwards the message upstream. If a mode change requires options at the stream head 
to be changed, an M_SETOPTS message is sent upstream. If the ICANON flag is turned on or 
off, the read mode at the stream head is changed to message-nondiscard (RMSGN) with read 
notification on (SO_MREADON) or byte-stream mode (RNORM) with read notification off 
(SO_MREADOFF ), respectively. I f the TOSTOP flag is turned on or off, the tostop mode at the 
stream head is turned on (SO_TOSTOP ) or off (SO_TONSTOP ), respectively. 

TCGETS The ldterm module forwards the M_lOCTL message downstream. When it receives the 
MIOCACK message in the read queue, it copies the CLOCAL flags and speeds from the mes¬ 
sage into the internal POSIX termios structure. Then, it copies the entire structure into the 
M IOCACK message and forwards the message upstream. 

TCSETA, TCSETAW, TCSETAF 

These commands set the old System V termio information. The ldterm module converts 
the message to a POSIX termios M_lOCTL message, then forwards the message with a 
corresponding POSIX termios command (i.e. TCSETS, TCSETSW, TCSETSF). The original 
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I/O control command and M_lOCTL message are stored for use on M_I0CACK. 

TCGETA This command get the old System V termio information. The ldterm module converts the 
message to a POSIX termios M_lOCTL message, then forwards the message with the 
TCGETS command. The original I/O control command and M_lOCTL message are stored to be 
used on M_IOCACK. When it receives the matching M_IOCACK message, the ldterm 
module processes it as for a TCGETS command, then converts the POSIX termios informa¬ 
tion into the System V termio information and replies. 

TCSBRK The ldterm module forwards this command downstream to be handled by the driver so that 
the driver has a chance to drain the data before sending an M_I0CACK message upstream. 

TCXONC This command controls the behavior of input/output flow control. If the argument is 0 and out¬ 
put is not already stopped, an M_STOP message is sent downstream. If the argument is 1 and 
the output is stopped, an M_START message is sent downstream. If the argument is 2 and 
input is not already stopped, an M_STOPl message is sent downstream. If the argument is 3 
and input is stopped, an M_STARTI message is sent downstream. 

TCFLSH This command flush the input or/and output streams. If the argument is 0, an M_FLUSH mes¬ 
sage with a flag byte of FLUSHR is sent downstream. This M_FLUSH (FLUSHR) message will 
be reflected back upstream by the driver to flush the entire input stream. If the argument is 1, 
an M_FLUSH message with a flag byte of FLUSHW is sent upstream. This 
M_FLUSH (FLUSHW) message will be reflected downstream by the stream head to flush the 
entire output stream. 

TIOCSWINSZ 

This command sets the window size variables. The argument of this command takes a pointer to 
a winsize structure. The ldterm module does not use the window size variable, but main¬ 
tains it here for any needed replies to TIOCGWINSZ commands. The module forwards the 
message downstream. 

TIOCGWINSZ 

When the ldterm module receives this command, it returns the window size variablethat was 
set by the last TIOCSWINSZ command. The argument of this command takes a pointer to a 
winsize structure. 

EUC_WSET 

This command sets the character widths and screen widths for the EUC character sets. The 
argument of this command takes a pointer to an eucioc structure which contains the informa¬ 
tion for setting the character widths and screen widths of the EUC character sets. After process¬ 
ing the command, ldterm forwards this message downstream to the next module. 

EUC_WGET 

This command returns the character widths and screen widths for the EUC character sets. This 
command takes a pointer to an eucioc structure via which the EUC character widths and 
screen widths information will be returned. 

EUCSET HP15 

This command put ldterm to the so called HP15 mode which enable ldterm to recognize 
the HP15 SJ IS, HP15 BIG5, HP15 CCDC, and HP15 GB character sets and process them in 
such a way that they behave like EUC characters. The argument for this command takes a 
pointer to an integer value which specify on of the above-mentioned four supported HP 15 charac¬ 
ter sets. If the argument is set to HP15_ASCI I, then ldterm will switch back to normal ASCII 
processing. EUC_WSET is mutually exclusive with EUC_SET_HP15 . 

EUCGET HP15 

This command returns the current HP15 character that has been set via the EUC_SET_HP15 
command. This command takes a pointer to an integer via which the result is returned. If no 
previous EUC_SET_HP15 has been issued, then it will return HP15 ASCII. 

BSD 4.3 Compatible Terminal I/O Commands 

The ldterm module acts on the foil owing I/O commands, which are compatible with the BSD I/O environ¬ 
ment: 

TIOCEXCL 

Set 'exclusive-use' mode. No further opens are permitted until the file has been closed. 


HP-UX Release 11.0: October 1997 


-4- 


Section 7-63 


Idterm(7) 


ldterm(7) 


TIOCNXCL 

Turn off 'exclusive-use' mode. 

TIOCSETD 

The ldterm module does nothing but reply to this command. I n a BSD system, the command 
is used to set the current line discipline type. It does not have much meaning in a STREAMS 
environment, because line discipline modules are changed by popping the current module from 
the stream and pushing a different one onto the stream. 

TIOCGETD 

In a BSD system, this command is used to get the current line discipline type. The command 
does not have much meaning in a STREAMS environment. The ldterm module replies with a 
valueof 2for binary compatibility, since ldterm supports job control. 

TIOCFLUSH 

This command flush the input or/and output streams similar to that of the TCFLSH command. 
The argument is a pointer to an int variable. If its value is zero, both the input and output 
streams are flushed by sending the appropriate FLUSHR/FLUSHW M__FLUSH messages 
upstream and downstream. Otherwise, the value of the int is treated as the logical OR of the 
FREAD and FWRITE flags defined by <sys/file.h> . If the FREAD flag is set, the input 
stream is flushed. If the FWRITE flag is set, theoutput stream isflushed. Then, ldterm ack¬ 
nowledges the message with M_lOCACK. 

TIOCOUTQ 

This command takes a pointer to an integer and returns the number of characters buffered up in 
the ldterm's output buffer. 

TIOCHPCL 

This command sets the POSIX termios HUPCL flag to indicate that the terminal lineshould 
be disconnected when the last file descriptor associated with that line is closed. The ldterm 
module converts the command into a compatible POSIX termios I/O control command by 
sending an M_lOCTL message containing the TCSETS command with current termios set¬ 
tings downstream. 

TIOCSTART 

The command restarts output. If the terminal was stopped, the ldterm module sends an 
M_START message downstream. 

TIOCSTOP 

This command stops output. The ldterm module sends an M_STOP message downstream. 

TIOCSBRK 

This command sets the break condition on a line. The ldterm module sends an M_BREAK 
message containing a valueof 1 as data to the driver, then replies with M_I0CACK 

TIOCCBRK 

This command clears the break condition on a line. The ldterm module sends an M_BREAK 
message containing a valueof 0 (zero) as data to the driver, then replies with M_lOCACK. 

TIOCSETP, TIOCSETN 

These commands set the sgttyb information, defined in <sys/ttold.h>. The argument is 
a pointer to an sgttyb structure. The ldterm module converts the message to a POSIX 
termios M_IOCTL message. Then, it forwards the POSIX termios M_IOCTL message 
with a corresponding POSIX termios command (i.e. TCSETSW, TCSETS). The original I/O 
control command and M_lOCTL message are stored for use on M_lOCACK. 

TIOCGETP 

This command returns the sgttyb information based on the interpretation of the current con¬ 
tent of the POSIX termios structure maintained in ldterm. The argument is a pointer to 
an sgttyb structure via where the information is returned. 

TIOCSETC 

This command sets the tchars information, defined in <sys/strtio.h>. The argument is 
a pointer to an tchars structure. The ldterm module converts the message to a POSIX 
termios M_IOCTL message. Then, it forwards the POSIX termios M_IOCTL message 
with a corresponding POSIX termios command (i.e. TCSETS). The original I/O control com¬ 
mand and M_lOCTL message are stored for use on M_lOCACK. 
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TIOCGETC 

This command returns the tchars information based on the interpretation of the current con¬ 
tent of the POSIX termios structure maintained in ldterm. The argument is a pointer to 
an tchars structure via where the information is returned. 

TIOCSLTC 

This command sets the ltchars information defined in <sys/bsdtty.h>. The ldterm 
module converts the message to a POSIX termios M_lOCTL message. Then, it forwards the 
POSIX termios M_IOCTL message with a corresponding POSIX termios command 
(i.e. TCSETS ). The original I/O control command and M_lOCTL message are stored for use on 

MIOCACK. 

TIOCGLTC 

The ldterm module returns the ltchars information based on the interpretation of the 
current content of the POSIX termios structure maintained in ldterm. 

TIOCLBIS, TIOCLBIC, TIOCLSET 

These commands set the BSD 4.3 flags information, defined in <sys/strtio.h>. For 
TIOCLBIS and TIOCLBIC, the argument is a pointer to an int whose value is a mask con¬ 
taining flags to be set/clear. For TIOCLSET, the argument is a pointer to an int whose value 
is a new set of flags to be set. The ldterm module converts the message to a POSIX ter¬ 
mios M_IOCTL, then forwards the POSIX termios M_IOCTL message with a correspond¬ 
ing POSIX termios command (i.e. TCSETS). It stores the original I/O control command and 
M_I0CTL message to be used on M_lOCACK. 

TIOCLGET 

The ldterm module returns the BSD 4.3 flags information based on the interpretation of the 
current content of the POSIX termios structure maintained in ldterm. 

TIOCSTI 

This command takes an argument of a pointer to a character and pretends that the character 
was typed on the terminal. The user must either have superuser privilege or have read permis¬ 
sion on the controlling terminal which theioctl is issued against. 

FIONREAD 

This command takes an argument of a pointer to an integer and returns the number of immedi¬ 
ately readable characters. 


AUTHOR 

ldterm was developed by PIP and OSF. 

SEE ALSO 

ioctl (2), streamio(7), termio(7), ptm(7), pts(7), ptem(7). 
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NAME 

Ip - line printer 

SYNOPSIS 

#include <sys/lprio.h> 

Remarks: 

This manual entry applies only to a certain group of printers. For Series 800 systems, it applies to 
printers controlled by the device drivers IprO, lprl, and lpr2. It does not apply to any 
printers on Series 700 systems. 

DESCRIPTION 

This section describes capabilities provided by many line printers supported by various versions of the hp- 
ux operating system. A line printer is a character special device that may optionally have an interpreta¬ 
tion applied to the data. 

If the character special device file has been created with the raw option (see the hp-ux System Administra¬ 
tor manuals for information about creating device files with the raw option), data is sent to the printer in 
raw mode (as, for example, when handling a graphics printing operation). I n raw mode, no interpretation 
is done on the data to be printed, and no page formatting is performed. Data bytes are simply sent to the 
printer and printed exactly as received. 

If the device file does not contain the raw option, data can still be sent to the printer in raw mode. Raw 
mode is set and cleared by theLPRSET request. 

If the line printer device file does not contain the raw option, data is interpreted according to rules dis¬ 
cussed below. The driver understands the concept of a printer page in that it has a page length (in lines), 
line length (in characters), and offset from the left margin (in characters). The default line length, indent, 
lines per page, open and close page eject, and handling of backspace are set to defaults determined when 
the printer is opened and recognized by the system the first time. If the printer is not recognized, the 
default line length is 132 characters, indent is 4 characters, lines per page is 66, one page is ejected on close 
and noneon open, and backspace is handled for a character printer. 

The foil owing rules describe the interpretation of the data stream: 

• A form feed causes a page eject and resets the line counter to zero. 

• Multipleconsecutive form-feeds are treated asa singleform-feed. 

• The new-line character is mapped into a carriage-return/line-feed sequence, and if an offset is 
specified a number of blanks are inserted after the carriage-return/line-feed sequence. 

• A new-line that extends over the end of a page is turned into a form-feed. 

• Tab characters are expanded into the appropriate number of blanks (tab stops are assumed to 
occur every eight character positions as offset by the current indent value). 

• Backspaces are interpreted to yield the appropriate overstrike either for a character printer or a 
line printer. 

• Lines longer than the line length minus the indent (i.e., 128 characters, using the above defaults) 
are truncated. 

• Carriage-return characters cause the line to be overstruck. 

• When it is opened or closed, a suitable number of page ejects is generated. 

Two ioctl (2) requests are available to control the lines per page, characters per line, indent, handling of 
backspaces, and number of pages to be ejected at open and close times. At either open or close time, if no 
page eject is requested the paper will not be moved. For opens, line and page counting will start assuming 
a top-of-form condition. 

The i octl requests have the foil owing form: 

#include <sys/lprio.h> 

int ioctl(int fildes, int request, struct lprio *arg); 

The possible values of request are: 

lprget Get the current printer status information and store in the lprio structure to which 
arg points. 
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lprset Set the current printer status information from the structure to which arg points. 

The lprio structure used in the lprget and lprset requests is defined in <sys/lprio.h>, and includes 
th e fol I owi n g members: 

short int ind; /* indent */ 

short int col; /* columns per page */ 

short int line; /* lines per page */ 

short int bksp; /* backspace handling flag */ 

short int open ej; /* pages to eject on open */ 

short int close ej; /* pages to eject on close */ 

short int raw mode; /* raw mode flag */ 

These are remembered across opens, so the indent, page width, and page length can beset with an external 
program. If the col field is set to zero, the defaults are restored at the next open. 

If the backspace handling flag is 0, a character printer is assumed and backspaces are passed through the 
driver unchanged. If the flag is a 1, a line printer is assumed, and sufficient print operations are generated 
to generate the appropriate overstruck characters. 

If the raw mode flag is 0, data sent to the printer is formatted according to indent, columns per page, lines 
per page, backspace handling, and pages to eject on open and close. 

If the raw mode flag is 1, data sent to the printer is not formatted. 

If the raw mode flag is changed from 1 to 0 (raw mode is turned off) and the format settings (indent, 
columns per page, etc.) have not been modified, the data is formatted according to the prior format set¬ 
tings. 

AUTHOR 

lp was developed by HP and AT&T. 

FILES 

/dev/lp default or standard printer used by some HP-UX commands; 

/dev/ [r] lp * special files for printers 

SEE ALSO 

lp(l), slp(l), ioctl (2), cent(7), intro(7). 
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NAME 

Ivm - Logical Volume Manager (LVM) 


DESCRIPTION 

The Logical Volume Manager (LVM) is a subsystem for managing disk space. The HP LVM subsystem 
offers value-added features, such as mirroring (with the optional HP MirrorDisk/UX software), high availa¬ 
bility (with the optional HP ServiceGuard software), and striping, that enhance availability and perfor¬ 
mance. 

Unlike earlier arrangements where disks were divided into fixed-sized sections, LVM allows the user to 
consider the disks, also known as physical volumes, as a pool (or volume) of data storage, consisting of 
equal-sized extents. The default size of an extent is 4 MB. 

An LVM system consists of arbitrary groupings of physical volumes, organized into volume groups. A 
volume group can consist of one or more physical volumes. There can be more than one volume group in 
the system. Once created, the volume group, and not the disk, is the basic unit of data storage. Thus, 
whereas earlier one would move disks from one system to another, with LVM, one would move a volume 
group from one system to another. For this reason it is often convenient to have multi pie volume groups on 
a system. 

Volume groups can be subdivided into virtual disks, called logical volumes. A logical volume can span a 
number of physical volumes or represent only a portion of one physical volume. The pool of disk space that 
is represented by a volume group can be apportioned into logical volumes of various sizes. The size of a log¬ 
ical volume is determined by its number of extents. Once created, logical volumes can be treated just like 
disk partitions. Logical volumes can be assigned to file systems, used as swap or dump devices, or used for 
raw access. 


Commands 

LVM information can be created, displayed, and manipulated with thefollowing commands: 


lvchange 

lvcreate 

lvdisplay 

lvextend 

lvlnboot 

lvmmigrate 

lvreduce 

lvremove 

lvrmboot 

pvchange 

pvcreate 

pvdisplay 

pvmove 

vgcfgbackup 

vgcfgrestore 

vgchange 

vgcreate 

vgdisplay 

vgexport 

vgextend 

vgimport 

vgreduce 

vgremove 

vgscan 


Change logical volume characteristics 

Stripe, create logical volume in volume group 

Display information about logical volumes 

I ncrease space, increase mirrors for logical volume 

Prepare logical volume to be root, primary swap, or dump volume 

Prepare root file system for migration from partitions to logical volumes 

Decrease number of physical extents allocated to logical volume 

Remove one or more logical volumes from volume group 

Remove logical volume link to root, primary swap, or dump volume 

Change characteristics of physical volume in volume group 

Create physical volume for usein volume group 

Display information about physical volumes within volume group 

Move allocated physical extents from one physical volume to other physical 

volumes 

Create or update volume group configuration backup file 

Display or restore volume group configuration from backup file 

Set volume group availability 

C reate vol u me grou p 

Display information about volume groups 

Export an volume group and its associated logical volumes 

Extend an volume group by adding physical volumes 

I mport an vol ume group onto the system 

Remove physical volumes from an vol ume group 

Remove volume group definition from the system 

Scan physical volumes for volume groups 


Thefollowing commands are also available if the HP MirrorDisk/UX software is installed: 


lvmerge 

lvsplit 

lvsync 

vgsync 


Merge two logical volumes into one logical volume 
Split mirrored logical volume into two logical volumes 
Synchronize stale mirrors in logical volumes 
Synchronize stale logical volume mirrors in volume groups 
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EXAMPLES 

The basic steps to take to begin usingLVM are as follows: 

• Identify the disks to be used for LVM. 

• Create an LVM data structure on each identified disk (see pvcreate(lM)). 

• Collect all the physical volumes to form a new volume group (see vgcreate(lM)). 

• Create logical volumes from the space in the volume group (see Ivcreate(lM)). 

• Use each logical volume as if it were a disk section (create a filesystem, or use for raw access). 

To configure disk /dev/dsk/cOtOdO as part of a new volume group named vgOl. 

First, initialize the disk for LVM with thepvcreate command. 

pvcreate /dev/rdsk/cOtOdO 
Then, create the pseudo device file that is used by the LVM subsystem, 
mkdir /dev/vgOl 

mknod /dev/vgOl/group c 64 0x030000 

The minor number for the group file should be unique among all the volume groups on the system. 
It has the format OxNN 0000, where NN ranges from 00 to 09. The maximum value of NN is con¬ 
trolled by the kernel tunable parameter, maxvgs. 

Create the volume group, vgOl, containing the physical volume, /dev/dsk/cOtOdO, with the 
vgcreate command. 

vgcreate /dev/vgOl /dev/dsk/cOtOdO 
You can view information about the newly created volume group with the vgdisplay command, 
vgdisplay -v /dev/vgOl 

Create a logical volume of size 100 MB, named usrvol, on this volume group with the lvcreate 
command. 

lvcreate -L 100 -n usrvol /dev/vgOl 

This creates two device files for the logical volume, /dev/vgOl/usrvol, which is the block device 
file, and /dev/vgOl/rusrvol, which is the character (raw) device file. 

You can view information about the newly created logical volume with the lvdisplay command, 
lvdisplay /dev/vgOl/lvoll 

Any operation allowed on a disk partition is allowed on the logical volume. Thus, you can use 
usrvol to hold a file system. 

newfs /dev/vgOl/rusrvol hp7937 
mount /dev/vgOl/usrvol /usr 


SEE ALSO 

Ivchange(lM), Ivcreate(lM), Ivdisplay(lM), Ivextend(lM), Ivlnboot(lM), Ivreduce(lM), Ivremove(lM), 
Ivrmboot(lM), pvchange(lM), pvcreate(lM), pvdisplay(lM), pvmove(lM), vgcfgbackup(lM), 
vgcfgrestore(lM), vgchange(lM), vgcreate(lM), vgdisplay(lM), vgexport(lM), vgextend(lM), vgimport(lM), 
vgreduce(lM), vgremove(lM), vgscan(lM). 

Managing Systems and Workgroups. 

If HP MirrorDisk/UX is installed: Ivmerge(lM), Ivsplit(lM), Ivsync(lM), vgsync(lM). 

If HP ServiceGuard is installed: cmcheckconf(lM), cmquerycl(lM), Managing MC/ServiceGuard. 
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NAME 

mem - main memory 

DESCRIPTION 

mem is a special file that is an image of the main memory of the computer. It may be used, for example, to 
examine and patch the system. 

Byte addresses in mem are interpreted as physical memory addresses. References to non-existent locations 
cause errors to be returned. 

File kmem is the same as mem except that kernel virtual memory rather than physical memory is accessed. 
Please refer to kmem(7) for information about ioctl operations that are supported on /dev/kmem. 

WARNINGS 

Examining and patching device registers is likely to lead to unexpected results when read-only or write- 
only bits are present. 

FILES 

/dev/mem 

/dev/kmem 

SEE ALSO 

kmem(7) 
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NAME 

modem - asynchronous serial modem line control 

SYNOPSIS 

#include <sys/modem.h> 

DESCRIPTION 

This section describes the two modes of modem line control and the three types of terminal port access. It 
also discusses the effect of the bits of the termio structure that affect modem line control. The modem 
related ioctl (2) system calls are discussed at the end of the document. 

Definitions 

There are several terms that are used within the following discussion which will be defined here for refer¬ 
ence. "Modem control lines" (CONTROL) are generally defined as those outgoing modem lines that are 
automatically controlled by the driver. "Modem status lines" (STATUS) are generally defined as those 
incoming modem lines that are automatically monitored by the driver, control and status for a termi¬ 
nal file vary according to the modem linecontrol mode of the file (see Modem line control modes below). An 
open(2) to a port will be considered to be blocked if it is waiting for another file on the same port to be 
closed. An open to a port is considered to bePENDiNG if it is waiting for theSTATUS to be raised. An open 
to a port isconsidered to be successful iftheopen system call has returned to the calling process without 
error. 

Open flag bits 

Currently, the only open flag bits recognized by the driver is theO NDELAY and ONONBLOCK bits. When 
either of these bits is set, an open call to the driver will never become blocked. If possible, the open will be 
returned immediately as successful, and the driver will continue the process of opening the tty file. If it 
is not possible, then the open will be returned immediately with the appropriate error code as described in 
the appropriate section. 

Termio bits 

When set, theCLOCAL bit in thetermios or termio structure (see termio(7)) is used to remove the driver's 
automatic monitoring of the modem lines. However, the user's ability to control the modem lines is deter¬ 
mined only by the mode in effect and does not depend on the state of CLOCAL. Normally, the driver will 
monitor and require the status to be raised. An open system call will raise theCONTROL and wait for the 
status before completing unless the clocal bit is set. (If the 0 _ndelay or O NONBLOCK bit is set, the 
open will be returned immediately, but the driver will otherwise continue to monitor the modem lines as 
normal based on the state of the clocal bit.) Normally, loss of the status will cause the driver to break 
the modem connection and lower theCONTROL. However, if clocal is set, any changes in theSTATUS will 
be ignored. A connection is required before any data may be read or written, unless clocal is set. Any 
timers that would normally be in effect (see Modem line control modes and Modem timers below) will be 
stopped whileCLOCAL is set. 

When theCLOCAL bit is changed from clear to set, the driver will assume the existence of an active device 
(such as a modem) on the port regardless of theSTATUS. If any of theCONTROL are raised at that point in 
time, they will continuein that state. TheSTATUS will no longer be actively monitored. When theCLOCAL 
bit is changed from set to clear, the driver will resume actively monitoring theSTATUS. If all of theCON¬ 
TROL and status are raised at that point in time, the driver will continuethe modem connection. If any of 
theSTATUS are not raised, the driver will act as though those signals were lost (as described in Modem line 
control modes below) and, if the device is a controlling terminal, a hangup signal will be sent to the control¬ 
ling process. If any of theCONTROL are not raised, the driver will break the modem connection by lowering 
all theCONTROL. 

The hupcl bit in the termi os or termio structure determines the action of the driver regarding the con¬ 
trol when the last close system call is issued to a terminal file. If the hupcl bit is set, the driver will 
lower theCONTROL at close time and the modem connection will be broken. If hupcl is not set and a 
modem connection exists, it will continueto exist, even after the close is issued. The driver will not change 
theCONTROL. 

Terminal port access types 

There are three types of modem access: call-in connections, call-out connections, and direct (no modem con¬ 
trol) connections. A given port may be accessed through all three types of connection by accessing different 
files. The modem access type of a terminal file is determined by the file's major and/or minor device 
numbers. 


HP-UX Release 11.0: October 1997 


- 1 - 


Section 7-71 


modem (7) 


modem (7) 


The call-in type of access is used when the connection is expected to be established by an incoming call. 
This is the type that would be used by gettyflM) to accept logins over a modem. When an open is issued to 
such a file, the driver may wait for an incoming call and will then raise the control based on the current 
mode (see below) of the port. When the port is closed, the driver may or may not lower the control 
depending on the HUPCL bit. 

The call-out type of access is used when the connection is expected to be established by an outgoing call. 
This would be used by programs such as uucp(l). When an open is issued to such a file, the driver will 
immediately raisetheCONTROL and wait for a connection based on the mode currently in effect. When the 
port is closed, the driver may or may not lower theCONTROL depending on the HU PCL bit. 

The direct type of access is used when no driver modem control is desired. This could then be used for 
directly connected terminals that use a three-wire connection, or to talk to a modem before a connection 
has been established. The second case allows a program to give dialing instructions to the modem. Neither 
the CLOCAL nor the hupcl bits have any effect on a port accessed through a direct file. (However, both 
bits may be inherited by other types of files; seeTerminal port access interlock below.) An open to a direct 
file does not affect the control and does not depend on any particular state of the status to succeed. 
When the file is closed, the driver will not affect the state of theCONTROL. If a modem connection has been 
established, it will continue to exist. Setting the speed of a direct file to BO (see termio(7) ) will be con¬ 
sidered an impossiblespeed change and will be ignored. It will not affect theCONTROL. 

Modem line control modes 

There are two modes of modem line control: CCITT mode and simple mode. A given port may have only 
one of these two modes in effect at any given point in time. An attempt to open a port with a mode other 
than the one in effect (from a pending or successful open on a different file) will cause the open to be 
returned with an ENXIO error. The modem access type of a terminal file is determined by the file's major 
and/or minor device numbers. 

CCITT mode is used for connections to switched line modems. TheCONTROL for CCITT mode are Data Ter¬ 
minal Ready (DTR) and Request to Send (RTS). The status are Data Set Ready (DSR), Data Carrier Detect 
(dcd), and Clear to Send (CTS). Additionally, the Ring Indicator (Ri) signal indicates the presence of an 
incoming call. When a connection is begun (an incoming call for a call-in fileor an open issued to a call-out 
file), theCONTROL are raised and a connection timer (see Modem timers below) is started. If the status 
become raised before the time period has elapsed, a connection is established and the open request is 
returned successfully. If the time period expires, theCONTROL are lowered and the connection is aborted. 
For a call-in file, the driver will wait for another incoming call; for a call-out file, the open will be returned 
with an El O error. Once a connection is established, loss of either dsr or CTS will cause the control to be 
lowered and, if the device is a control ling terminal, a hangupsignal will be sent to the control ling process. 

If dcd is lost, a timer is started. If dcd resumes before the time period has expired, the connection will be 
maintained. However, no data transfer will occur during this time. Thedriver will stop transmitting char¬ 
acters, and any characters received by the driver will be discarded. (However, on some implementations 
data transmission cannot be stopped. See DEPENDENCIES.) If dcd is not restored within the allotted 
time, the connection will be broken as described above for dsr andCTS. 

If the modem connection is to be broken when the close system call is issued (i.e. hupcl is set), then the 
control will be lowered and the close will be returned as successful. However, no further opens will be 
allowed until after both dsr and CTS have been lowered by the modem, and the hangup timer (see Modem 
timers below) has expired. The action taken in response to an open during this time will be the same as if 
the port were still open. (SeeTerminal port access interlock below.) 

When a port is in CCITT mode, the driver has complete control of the modem lines and the user is not 
allowed to change the setting of the control or affect which status are actively monitored by the driver 
(see Modem ioctls below). This is to provide strict adherence with the CCITT recommendations. 

Simple mode is used for connections to devices which require only a simple method of modem line control. 
This can include devices such as black boxes, data switches, or for system-to-system connections. It can 
also be used with modems which cannot operate under the CCITT recommendations. The control for 
simple mode consists of only dtr. The status consists of only dcd. When an open is issued, theCONTROL 
is raised but no connection timer is started. When the status becomes raised, a connection is established 
and the open request is returned as successful. Once a connection is established, loss of theSTATUS will 
cause the control to be lowered and, if the device is a controlling terminal, a hangup signal will be sent to 
the control ling process. 

When a port is in simple mode, the driver will normally control the modem lines. However, the user is 
allowed to change the setting of theCONTROL (see Modem ioctls below). 
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Terminal port access interlock 

An interlock mechanism is provided between the three access types of terminal files. It prevents more than 
one file from being successfully opened at a time, but allows certain opens to succeed while others are 
pending so that a port can be opened through a call-out connection while getty has a pending open at a 
call-in connection. The three access types are given a priority that determines which open will succeed if 
more than onefilehasan open issued against it. The three access types are ordered from lowest priority to 
highest as follows: call-in, call-out, and direct. 

If an open is issued to a port which already has a successful open on it of a lower priority type, the new 
open will be returned with an EBUSY error. (EBUSY will also be returned by an attempted open on a 
CCITT call-out file if an incoming call indication is currently being received. In this case, if there is a 
pending open on the corresponding CCITT call-in file, this pending open will complete.) If the lower 
priority open is pending, the new open will succeed if possible, or will be left pending if waiting for the 
status and the lower priority open will become blocked. If a higher priority open has succeeded or is 
pending, the new open will be blocked, uni ess the new open has the ON delay flag bit set, in which case 
the open will be returned with an EBUSY error. Once an open on one type of file is successful, any 
pending open son lower priority files will become blocked. 

When a file of one priority is closed, a blocked open on the next lower priority type file will become active. 
If all of the status are raised, the open will be successful, otherwise the open will become pending 
waiting for the status. Ifthelower priority open isSUCCESSFUL (because the connection was maintained 
when the higher priority file was closed), the port characteristics (speed, parity, etc.) that were set by the 
higher priority file will be inherited by the lower priority file. If the connection is not maintained through 
thedose, the port characteristics will be set to default values. 

Modem timers 

There are four timers currently defined for use with modem connections. The first three of the timers are 
applicable only to CCITT mode connections. In general, the effect of changing a timer value while the 
timer is running is system dependent. However, setting the timer value to zero is guaranteed to disable 
the timer even if it is running. 

The connect timer is used to limit the amount of time to wait for a connection to be established once it has 
been begun. This timer is started when an incoming call has been received on a call-in file, or when an 
open has been issued on a call-out file for which no opens are already pending. If the connection is com¬ 
pleted in time, the timer is aborted. If the time period expires, the connection is aborted. For a call-in file, 
the driver will again wait for an incoming call and the open will remain pending. For a call-out file, the 
open will be returned with an EIO error. 

The carrier detect timer is used to limit the amount of time to wait before causing a disconnect if dcd 
drops. If carrier is not re-established in this time, a disconnect will occur. If carrier is re-established before 
the timeout, the timer will be aborted and the connection maintained. During the period when carrier is 
not raised, no data will be transferred across the line. 

The no activity timer is used to limit the amount of time a connection will remain open with no data 
transfer across the line. When the data line becomes quiescent with no data transfer, this timer will be 
started. If data is again transferred over the line in either direction before the time limit, the timer will be 
aborted. If no activity occurs before the timeout has occurred, the driver will disconnect the line. Thiscan 
be used to avoid long and costly telephone connections when data transfer has been stopped either normally 
or abnormally. 

The last timer defined, the hangup timer, is used for both CCITT and simple modes. This timer controls 
the amount of time to wait after disconnecting a modem line before allowing another open. This time 
period should be made long enough to guarantee that the connection has been terminated by the telephone 
switching equipment. If this period is not long enough, the telephone connection may not be broken and a 
succeeding open may complete with theold connection. 


HP-UX Modem ioctls 

Several ioctl system calls apply to manipulation of modem lines. They use the following information 
defined in <sys/modem.h>: 


fdefine NMTIMER 6 
typedef unsigned long 
struct mtimer { 

unsigned short 
}; 


mflag; 

m_timers[NMTIMER]; 
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Each bit of the mflag long corresponds to one of the modem lines as follows: 

MRTS Request to Send outbound 

MCTS Clear to Send inbound 

MDSR Data Set Ready inbound 

MDCD Data Carrier Detect inbound 

MDTR Data Terminal Ready outbound 

MRI Ring I ndicator inbound 

MDRS Data Rate Select outbound 

The timer values are defined in the array m_timers. The relative position of the timer and default initial 
values and units for each timer are as follows: 

0 MTCONNECT 25s 

1 MTCARRIER 400 ms 

2 MTNOACTIVITY Omin 

3 MTHANGUP 250 ms 

4 Reserved 

5 Reserved 

A valueof zero for any timer will disablethat timer. 

The modem lineioctl system calls have the form: 

int ioctl(int fildes, int command, mflag *arg); 

The commands using this form are: 

mcgeta Get the current state of both inbound and outbound modem lines and store in the mflag 

long referenced by arg. A raised line will be indicated by a one bit in the appropriate posi¬ 
tion. 

MCSETA Set the outbound modem lines from the mflag long referenced by arg. Setting an out¬ 

bound bit to one causes that line to be raised and zero to be lowered. Setting bits for 
inbound lines has no effect. Setting any bits while in CCITT mode has no effect. The 
change to the modem lines is immediate and using this form while characters are still being 
output may cause unpredictable results. 

mcsetaw Wait for the output to drain and set the new parameters as described above. 

mcsetaf Wait for the output to drain, then flush the input queue and set the new parameters as 

described above. 

The timer value ioctl system calls have the form: 

int ioctl(int fildes, int command, mtimer *arg); 

The commands using this form are: 

mcgett Get the current timer valuesettings and store in the mtimer structure referenced by arg. 
mcsett Set the timer values from the structure referenced by arg. 

For any timer, setting the timer value to its previous value has no effect. 

SVID3 Modem ioctls 

System V Interface Definition, Third Edition (SVID3) specifies additional ioctl system calls to manipulate 
the modem lines. They use information defined in <termios .h> . 

Each ioctl passes an integer argument in which each of thefollowing bit definitions correspond to one of the 
modem I i nes as fol I ows: 


TIOCM_RTS Request to Send outbound 

TIOCM CTS Clear to Send inbound 

TIOCM_DSR Data Set Ready inbound 

TIOCM CAR Data Carrier Detect inbound 

TIOCM_DTR Data Terminal Ready outbound 

TIOCM_RNG Ring I ndicator inbound 


Additionally, TIOCM CD isequivalenttoTIOCM CAR, andTIOCM RI isequivalenttoTIOCM RNG. 
The modem lineioctl system calls have the form: 
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int ioctl(int fildes, int command, int *arg); 

The commands using this form are: 

tiocmget Get the current state of both inbound and outbound modem lines and store in the int refer¬ 
enced by arg. A raised line will be indicated by a one bit in the appropriate position. 

TIOCMSET Set the outbound modem lines from the int referenced by arg. 

tiocmbis Raise the control lines specified by a one in the corresponding bit positions of the int refer¬ 

enced by arg. 

tiocmbic Lower the control lines specified by a one in the corresponding bit positions of the int refer¬ 
enced by arg. 

Note that setting bits for inbound lines has no effect, and setting any bits while in CCITT mode has no 
effect. Also, the change to the modem lines is immediate and using these ioctl's while characters are still 
being output may cause unpredictable results. 

WARNING 

Occasionally it is possible that a process may open a call-out file at approximately the same time as an 
incoming call is received. In some cases, the call-out connection may be satisfied by the incoming call. In 
general, however, the results are indeterminate. If necessary, the situation can be avoided by the use of 
two modems and ports, onefor call-out connections and theother for receiving incoming calls. 

DEPENDENCIES 

Some hardware implementations may not have access to all modem lines supported by mcseta. If a partic¬ 
ular hardware does not support a given line, attempts to set the valueof a linewill beignored, and reading 
the current state of the line will return zero. The appropriate I/O card manual should be referenced to 
determine the lines supported by the hardware installed. 

Some hardware implementations may not have access to all timers supported by mcsett. Also, the granu¬ 
larity of the individual timers may vary depending on the hardware and system in use. The effect of set¬ 
ting a timer out of range or with a granularity outside the capability of a particular system should be docu¬ 
mented by that system. The effect of changing the value for a timer while that timer is running is system 
dependent and should be documented by each system. 

Setting the CLOCAL bit while a timer is running will cause the timer to be stopped. It is a system depen¬ 
dency whether or not the timer is restarted, and if so, the value at which it is restarted when the CLOCAL 
bit is subsequently cleared. 

On those implementations supporting the HP27140A 6-Channel Multiplexer, transmission of characters 
cannot be stopped during loss of dcd. The driver cannot detect loss of dcd until the connection is broken. 
Also, the I/O card may still have characters in its internal buffers and will still try to transmit them. 

AUTHOR 

modem was developed by HP and AT&T. 

FILES 

/dev/cua * 

/dev/cul* 

/dev/tty * 

/dev/ttyd* 

EISA mux has adopted thefollowing device files naming convention: 

/dev/<cua | cul | tty | ttydxl nstance_Number><Port_Module_Name><Port_Number> 
where Port_Module_Name = [a..h], Port_Number =1-16 

For example: /dev/cua2al, /dev/cul2b8 , /dev/tty2gl2 , /dev/ttyd2hl6 

SEE ALSO 

stty(l), mknod(lM), ioctl(2), open(2), termio(7). 
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NAME 

mt - magnetic tape interface and controls for stape, tapel and tape2 

DESCRIPTION 

This entry describes the behavior of HP magnetic tape interfaces and controls, including reel-to-reel, dds, 
QIC, 8mm, and 3480 tape drives. Thefiles /dev/rmt/* refer to specific raw tape drives, and the behavior 
of each given unit is specified in the major and minor numbers of the device special file. 

Naming Conventions 

There are two naming conventions for device special files. The standard (preferred) convention is used on 
systems that support long file names. An alternate convention is provided for systems limited to short file 
names. The following standard convention is recommended because it allows for all possible configuration 
options in the device name and is used by mksf(lM) and insf(lM): 

/dev/rmt/c #t#i#[o][z][e][p][s[#]][w]density[c[#]][n][b] 

The following alternate naming convention is provided to support systems in which the /dev/rmt direc¬ 
tory requires short file names. These device special file names are less descriptive, but guarantee unique 
device naming and are used by mksf(lM) and insf(lM) where required. 

/dev/rmt/c #t#i#[f #| i#][n][b] 

For each tape device present, eight device files are automatically created when the system is initialized. 
Four of these device files utilize either the standard (long file name) or alternate (short file name) naming 
conventions. When the standard naming convention is being utilized, these four files contain the density 
specification "BEST". When the alternate naming convention is being utilized, these four files contain the 
density specification "fO". There are four such files because each of the four different permutations of the 
"n" and "b" options (see below) is available. 

The remaining four files automatically created when the system is initialized utilize the pre-FIP-UX 10.0 
device file naming convention. This includes an arbitrary number to distinguish this tape device from oth¬ 
ers in the system, followed by the letter m. There are four such files because each of the four different per¬ 
mutations of the n and b options (see below) is available. These files are created as a usability feature for 
pre-FIP-UX 10.0 users who do not wish to acquire familiarity with the standard or alternate naming con¬ 
ventions. 

Each of the automatically created four device files which utilize the standard or alternate naming conven¬ 
tions is linked to a device file which utilizes the pre-FIP-UX 10.0 naming convention. Thus, the device files 
which utilize the pre-HP-UX 10.0 naming convention provide the same functionality as the device files 
which contain the density specification BEST (standard naming convention) or fO (alternate naming con¬ 
vention). 

Options 

The options described here are common to all tape drivers. The c#tM#notation in the device special file 
name derives from ioscan output and is described on the manpagesfor ioscan(lM) and intro(7). Options 
unique to stape, tapel, and tape2, are described later in this manpage, in the DEPENDENCIES sec¬ 
tion. 

c# I nstance number assigned by the operating system to the interface card, 
t# Target address on a remote bus (for example, SCSI or HP-1 B address) 

d# Device unit number at the target address (for example, SCSI LUN). 

w Writes wait for physical completion of the operation before returning status. The default 

behavior (buffered mode or immediate reporting mode) requires the tape device to buffer the 
data and return immediately with successful status. 

density Density or format used in writing data to tape. This field is designated by the foil owing values: 

BEST Highest-capacity density or format will be used, including data compression, if 

the device supports compression. 

NOMOD Maintains the density used for data previously written to the tape. Behavior 
using this option is dependent on the type of device. This option is only sup¬ 
ported on DDS and 8M M drives. 

DDS Selects one of the known DDS formats; can be used to specify DDS1 or DDS2, as 

required. 
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Selects one of the known DLT formats; can be used to specify DLT42500_24 : 
DLT42500 56, DLT62500 64, DLT81633 64, or DLT85937 52, as required. 

Selects one of the known QIC formats; can be used to specify QIC11, QIC24, 
QIC 120, QIC 150, QIC525, QIC1000, QIC1350, QIC2100, QIC2GB, or QIC5GB, 
as required. 

Selects one of the known 8MM formats; can be used to specify D8MM8200 or 
D8MM8500, as required. 

Selects a reel-to-reel density; can be used to specify D800, D1600, or D6250, as 
required. 

Specifies that the device special file communicates with a 3480 device. (There is 
only one density option for 3480.) 

Specifies density as a numeric value to be placed in the SCSI mode select block 
descriptor. Thisoption is not available with HP-IB tapedevices. The header file 
<sys/mtio.h> contains a list of the standard density codes. The numeric 
value is used only for density codes which cannot be found in this list. 

C [#] Write data in compressed mode, on tape drives that support data compression. If a number is 
included, use it to specify a compression algorithm specific to the device. Note, compression is 
also provided when the density field is set to BEST. 

n No rewind on close. Unless this mode is requested, the tape is automatically rewound upon 

close. 

b Specifies Berkeley-style tape behavior. When the b is absent, the tape drive follows AT&T-style 

behavior. The details are described in 'Tape Behavioral Characteristics" below. 

f# Specify format (or density) value encoded in the minor number. The meaning of the value is 
dependent on the type of tape device in use. (Used for short file name notation only.) 

i# Specify an internal Property Table index value maintained by the tape driver, containing an 
array of configuration options. The contents of this table are not directly accessible. Use the 
Issf(lM) command to determine which configuration options are invoked. (Used for short file 
name notation only.) 

SampleTape Device Special File Names 

For a QIC150 device at SCSI address 3, card instance 2, with default block size, buffered mode, and AT&T- 
style with rewind on close, the standard device special file name is /dev/rmt/c2t3d0QlC150. 

For a device at card instance 1, target 2, LUN 3, with exhaustive mode enabled (see DEPENDENCIES), 
fixed block size of 512 bytes, DDS1 density with compression, AT&T-style with no rewind on close, the stan¬ 
dard device file special name is /dev/rmt/clt2d3es512DDSlCn. 

For a system requiring short file names, the same device special file would be named 
/dev/rmt/clt2d3i<#>n, where <#> isan index valueselected by the tape driver. 

Use the lssf(lM) command to determine which configuration options are actually used with any device file. 
The naming convention defined above should indicate the options used, but device files may be created with 
any user defined name. 

Tape Behavioral Characteristics 

When opened for reading or writing, the tape is assumed to be positioned as desired. 

When a file opened for writing is closed, two consecutive EOF (End of File) marks are written if, and only if, 
one or more writes to the file have occurred. The tape is rewound unless the no-rewind mode has been 
specified, in which case the tape is positioned before the second EOF just written. For QIC devices only one 
EOF mark is written and the tape is positioned after the EOF mark (if the no-rewind mode has been 
specified). 

When a file open for reading (only) is closed and the no-rewind bit is not set, the tape is rewound. If the 
no-rewind bit is set, the behavior depends on the style mode. For AT&T-style devices, the tape is positioned 
after the EOF following the data just read (unless already at BOT or Filemark). For Berkeiey-styie devices, 
the tape is not repositioned in any way. 

Each read(2) or write(2) call reads or writes the next record on the tape. For writes, the record has the 
same length as the buffer given (within the limits of the hardware). 


DLT 

QIC 

D8MM 

D 

D3480 

D[#] 
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During a read, the record size is passed back as the number of bytes read, up to the buffer size specified. 
Since the minimum read length on a tape device is a complete record (to the next record mark), the 
number of bytes ignored (for records longer than the buffer size specified) is available in the mt_resid 
field of the mtget structure via the mtiocget call of ioctl (2). Current restrictions require tape device 
application programs to use 2-byte alignment for buffer locations and I/O sizes. Toallowfor more stringent 
future restrictions (4-byte aligned, etc.) and to maximize performance, page alignment is suggested. For 
example, if the target buffer is contained within a structure, care must be taken that structure elements 
before the buffer allow the target buffer to begin on an even address. If need be, placing a filler integer 
before the target buffer will insure its location on a 4-byte boundary. 

The ascending hierarchy of tape marks is defined as follows: record mark, filemark (EOF), setmark and 
EOD (End of Data). Not all devices support all types of tape marks but the positioning within the hierarchy 
holds true. Each type of mark is typically used to contain oneor more of the lesser marks. 

When spacing over a number of a particular type of tape mark, hierarchically superior marks (except EOD) 
do not terminate tape motion and are included in the count. For instance, MTFSR can be used to passover 
record marks and filemarks. 

Reading an EOF mark is returned as a successful zero-length read; that is, the data count returned is zero 
and the tape is positioned after the EOF, enabling the next read to return the next record. 

dds devices and the 8mm 8505 device also support setmarks , which are used to delineate a group (set) of 
files. For the 8mm 8505 setmarks are only supported when the density is set to 8500 plus compression. 
Reading a setmark is also returned as a zero-length read. Filemarks, setmarks and EOD can be dis¬ 
tinguished by uniquebits in the mt_gstat field. 

Spacing operations (back or forward space, setmark, file or record) position past the object being spaced to 
in the direction of motion. For example, back-spacing a file leaves the tape positioned before the file mark; 
forward-spacing a file leaves the tape positioned after the file mark. This is consistent with standard tape 
usage. 

For QIC devices, spacing operations can take a very long time. I n the worst case, a space command could 
take as much as 2 hours! Whilethis command is in progress, the device is not accessiblefor any other com¬ 
mands. 


Iseek(2) type seeks on a magnetic tape device are ignored. Instead, the ioctl(2) operations below can be 
used to position the tape and determine its status. 

The header file <sys/mtio .h > has useful information for tape handling. The following is included from 
<sys/mtio .h >and describes the possible tape operations: 

/* mag tape I/O control requests */ 

#define MTIOCTOP _IOW('m', 1, struct mtop) /* do mag tape op */ 

#define MTIOCGET _IOR('m', 2, struct mtget) /* get tape status */ 

/* structure for MTIOCTOP - mag tape op command */ 


struct mtop { 

short mt_op; /* operations defined below */ 

daddr_t mt_count; /* how many of them */ 

} ; 


/* operations */ 


#define 

MTWEOF 

0 

/* 

#define 

MTFSF 

1 

/* 

#define 

MTBSF 

2 

/* 

#define 

MTFSR 

3 

/* 

#define 

MTBSR 

4 

/* 

#define 

MTREW 

5 

/* 

#define 

MTOFFL 

6 

/* 

#define 

MTNOP 

7 

/* 

#define 

MTEOD 

8 

/* 

#define 

MTWSS 

9 

/* 

#define 

MTFSS 

10 

/* 

#define 

MTBSS 

11 

/* 


write filemark (end-of-file record) */ 

forward space file */ 

backward space file */ 

forward space record */ 

backward space record */ 

rewind */ 

rewind and put the drive offline (may eject) */ 
no operation, may set status */ 

DDS, QIC and 8MM only - seek to end-of-data */ 
DDS and 8MM only - write setmark(s) */ 

DDS and 8MM only - space forward setmark(s) */ 

DDS and 8MM only - space backward setmark(s) */ 


/* structure for MTIOCGET - mag tape get status command */ 
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struct mtget { 

long mt_type; /* type of magtape device */ 

long mt_resid; /* residual count */ 

/* The following two registers are device dependent */ 

long mt_dsregl; /* status register (msb) */ 

long mt_dsreg2; /* status register (lsb) */ 

/* The following are device-independent status words */ 


long 

long 

daddr_t 

daddr_t 


mt_gstat; 
mt_erreg; 
mt_fileno; 
mt_blkno; 


/* generic status */ 

/* error register */ 

/* No longer used - always set to -1 */ 

/* No longer used - always set to -1 */ 


I nformati on for decoding the mt_type field can be found in <sys/mtio.h>. 


Other Tape Status Characteristics 

Efficient use of streaming tape drives with large internal buffers and immediate-reporting require the fol¬ 
lowing end-of-tape procedures: 

All writes near leot (Logical End of Tape) complete without error if actually written to the tape. 
Once the tape driver determines that LEOT has been passed, subsequent writes do not occur and an 
error message is returned. 

To write beyond this point (keep in mind that streaming drives have already written well past leot), 
simply ask for status using the MTIOCGET ioctl. If status reflects the EOT condition, the driver drops 
all write barriers. For reel-to-reel devices, caution must be exercised to keep the tape on the reel. 

When immediate-reporting is enabled, the tapel and tape2 drivers will drop out of immediate mode and 
flush the device buffer with every write filemark or write setmark. The stape driver will flush the device 
buffers when a write filemark or write setmark command is given with the count set to zero. 

When immediate-reporting is disabled, the write encountering leot returns an error with the tape driver 
automatically backing up over that record. 

When reading near the end-of-tape, the user is not informed of leot. Instead, the typical double EOF 
marks or a pre-arranged data pattern signalsthe logical end-of-tape. 

Since magnetic tape drives vary in EOT sensing due to differences in the physical placement of sensors, any 
application (such as multiple-tape cpio(l) backups) requiring that data be continued from the EOT area of 
one tape to another tape must be restricted. Therefore, the tape drive type and mode should be identical 
for the creation and reading of the tapes. 


The following macros are defined in <sys/mtio.h>for decoding the status field mtgstat returned from 
IMTIOCGET. For each macro, the input parameter <x>is the mt gstat field. 


GIMTBOT(x) 
GIMTEOD(x) 
GIMTEOF (x) 
GMTEOT(x) 

GIMTJ IM_REP_EN(x) 
GIMTONLINE(x) 
GIMT_SIM (x) 
GMTWRPROT(x) 
GIMTCOIM PRESS(x) 
GIMT DENSITY(x) 


Returns TRUE at beginning of tape. 

ReturnsTRUE if End-of-Data is encountered for DDS, QIC or 8MM. 
Returns TRUE at an End-of-Filemark. 

Returns TRU E at end of tape. 

ReturnsTRUE if immediate reporting mode is enabled. 

ReturnsTRUE if drive is on line. 

ReturnsTRUE if setmark is encountered. 

ReturnsTRUE if tape is write protected. 

ReturnsTRUE if data compression is enabled. 

Returns the currently configured 8-bit density value. Supported values are 
defined in <sys/mtio.h>. 


GMT QI C_FORM AT(x) and GMT_8mm_FORM AT(x) 

Return the same information as does GMTDENSITY(x). 
GMTDENSITY(x) is preferred because GMTQICFORMAT and 
GMT_8mm_FORMAT may be obsoleted at some future date. 
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GMT_D_800(x) ReturnsTRUE if the density encoded in mt_gstat is800bpi. 

GMT_D_1600(x) ReturnsTRUE if the density encoded in mt_gstat isl600bpi. 

GMT_D_6250(x) ReturnsTRUE if the density encoded in mt_gstat is 6250 bpi (with or 

without compression). 

GMT_D_6250c(x) Returns TRUE if the density encoded in mt_gstat is 6250 bpi plus 

compression. 

GMTDDDSl(x) Returns TRUE if the density encoded in mt_gstat is DDS1 (with or 

without compression). 

GMTDDDSlc(x) Returns TRUE if the density encoded in mt_gstat is DDS1 plus 

compression. 

GMT_D_DDS2(x) Returns TRUE if the density encoded in mt_gstat is DDS2 (with or 

without compression). 

GMT_D_DDS2c(x) Returns TRUE if the density encoded in mt_gstat is DDS2 plus 

compression. 

GMTDD LT_42500_24(x) 

ReturnsTRUE if the density encoded in mt_gstat is 42500bpi, 24 track 
pairs. 

GMTDD LT_42500_56(x) 

ReturnsTRUE if the density encoded in mt_gstat is 42500 bpi, 56 track 
pairs. 

■ GMTDD LT_62500_64(x) 

ReturnsTRUE if the density encoded in mt_gstat is 62500 bpi (with or 
without compression). 

GMT D DLT 62500 64c(x) 

m Returns TRUE if the density encoded in mt_gstat is 62500 bpi plus 

compression. 

GMTDD LT_81633_64(x) 

ReturnsTRUE if the density encoded in mt_gstat is 81633 bpi (with or 
without compression). 

GMTDD LT_81633_64c(x) 

Returns TRUE if the density encoded in mt_gstat is 81633 bpi plus 
compression. 

GMTDD LT_85937_52(x) 

ReturnsTRUE if the density encoded in mt_gstat is 85937 bpi (with or 
without compression). 

GMTDD LT_85937_52c(x) 

Returns TRUE if the density encoded in mt_gstat is 85937 bpi plus 
compression. 

GMT_D_3480(x) ReturnsTRUE if the density encoded in mt_gstat is for a 3480 device 

(with or without compression). 

GMT_D_3480c(x) ReturnsTRUE if the density encoded in mt_gstat is for a 3480 device 

with compression. 

GMT_D_QIC_ll(x) ReturnsTRUE if the density encoded in mt_gstat is QIC-11 format. 

GMT_D_QIC_24(x) ReturnsTRUE if the density encoded in mt_gstat is QIC-24 format. 

GMT_D_QIC_120(x) ReturnsTRUE if the density encoded in mt_gstat is QIC-120 format. 

GMT_D_QIC_150(x) ReturnsTRUE if the density encoded in mt_gstat is QIC-150 format. 

GMT_D_QIC_525(x) ReturnsTRUE if the density encoded in mt_gstat is QIC-525 format. 

GMT_D_QIC_1000(x) ReturnsTRUE if the density encoded in mt_gstat is QIC-1000 format. 

GMT_D_QIC_1350(x) ReturnsTRUE if the density encoded in mt_gstat is QIC-1350 format. 
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GMTDQI C_2100(x) 

G M T_D_Q I C_2G B (x) 

G M T_D_Q I C_5G B (x) 
GIMT_D_8M M_8200(x) 

GMT_D_8MM_8200c(x) 

GMT_D_8MM_8500(x) 

GMTD8M M_8500c(x) 


ReturnsTRUE if the density encoded in mt_gstat is QIC-2100 format. 
ReturnsTRUE if the density encoded in mt_gstat is QIC-2GB format. 
ReturnsTRUE if the density encoded in mt_gstat is QIC-5GB format. 

Returns TRUE if the density encoded in mt_gstat is 8 millimeter 8200 
format (with or without compression). 

Returns TRUE if the density encoded in mt_gstat is 8 millimeter 8200 
format with compression. 

Returns TRUE if the density encoded in mt_gstat is 8 millimeter 8500 
format (with or without compression). 

Returns TRUE if the density encoded in mt_gstat is 8 millimeter 8500 
format with compression. 


GMT_M EDI U M (x) I dentifies the 8-bit medium type value describing the tape currently loaded 

into the tape device. The reported value is only valid for QIC and 8mm 
devices. Supported values are defined in <sys/mtio.h>. 

GMT_QIC_MEDI UM(x) Returns the same information as does GMT_MEDIUM(x). 

GMT_MEDI UM(x) is preferred because GMT_QIC_MEDIUM may be 
obsoleted at some future date. 


GMTDROPEN(x) Does not apply to any currently supported devices. Always returns FALSE. 

hp-ux silently enforces a tape record blocking factor (MAXPHYS) on large I/O requests. For example, a user 
write request with a length often times maxphys will actually reach the media as ten separate records. A 
subsequent read (with ten times maxphys as a length) will look like a single operation to the user, even 
though hp-ux has broken it up into ten separate read requests to the driver. The blocking function istran- 
sparent to the user during writes. It is also transparent during reads unless: 

• The user picks an arbitrary read length greater than maxphys. 

• The user attempts to read a third-party tape containing records larger than maxphys. 

Since the value for maxphys is relatively large (usually >=256K bytes), this is typically not a problem. 
TheMTNOP operation does not set the device-independent status word. 

3480 stacker devices are supported only in auto (that is, sequential-access) mode. To advance to the next 
tape in the stack, an MTIOCTOP control request specifying an MTOFFL operation should be issued. An 
MTIOCGET control request should then be issued to determine whether or not the stacker has been suc¬ 
cessfully advanced. Failure on the MTIOCGET operation (or an offline status) indicatesthat no more tapes 
are available in the stacker, the stacker has been ejected, and user intervention is required to load a new 
stack. 


EXAMPLES 

Assuming that fd is a valid file descriptor, the following example writes two consecutive filemarks on the 
tape: 

#include <sys/types.h> 

#include <sys/mtio.h> 

struct mtop mtop; 

mtop.mt_op = MTWEOF; 

mtop.mt_count = 2; 

ioctl(fd, MTIOCTOP, Smtop); 

If fd is a valid file descriptor for an open dds drive, the following example spaces forward to just past the 
next setmark: 

#include <sys/types.h> 

#include <sys/mtio.h> 

struct mtop mtop; 

mt op.mt_op = MTF S S; 

mtop.mt_count = 1; 

ioctl(fd, MTIOCTOP, &mtop); 
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Given that fd is a valid file descriptor for an opened tape device, and that it has just returned 0 from a 
read (2) request. The foil owing system call verifies that the tape has just read a filemark: 

#include <sys/types.h> 

#include <sys/mtio.h> 

struct mtget mtget; 

ioctl (fd, MTIOCGET, Smtget); 
if (GMT_EOF (mtget.mt_gstat)) { 

/* code for filemark detection */ 

} 

WARNINGS 

Density specifications BEST (standard naming convention) or fO (alternate naming convention) activate 
data compression on tape devices which support compression. This is also true for the files using the pre- 
HP-UX 10.0 naming convention which arelinked to these files (see "Naming Conventions" above). 

This means that a tape written using one of the eight device files (which are automatically created when 
the system is initialized) on a tape device which supports data compression, will contain compressed data. 
This tape cannot be successfully read on a tape device which does not support compressed data. For exam¬ 
ple, a tape written (using one of the eight automatically created device files) on a newer DDS device which 
supports data compression cannot be read on an older DDS device which does not support data compres¬ 
sion. 

To accomplish data interchange between devices in a case such as this, a new device file must be manually 
created using the mksf(lM) command. In the above example, the options specified to mksf(lM) should 
includea density option with an argument of DDS1, and must not includea compression option. 

Use the mksf(lM) command instead of the mknod(lM) command to create tape device files. As of the 10.0 
release, there are more configuration options than will fit in the device file's minor number. Prior to the 
10.0 release, it was possibleto select configuration options by directly setting the bits in the device special 
file's minor number using mknod(lM). 

As of the 10.0 release, a base set of configuration options are contained in the minor number. Extended 
configuration options are stored in a table of configuration properties. The minor number may contain an 
index into the property table, which is maintained by the tape driver and is not directly visible to the user. 
The mksf(lM) command sets the minor number and modifies the property table as needed based on 
mnemonic parameters passed into the command. 

If your device configuration requirements are limited to the base set of options, you need not be concerned 
with the property table. The base configuration options are as follows: 

• hardware address (card instance, target, and unit number) 

• density (from the set of pre-defined options listed in mksf(lM)) 

• compression (using the default compression algorithm) 

• rewind or no rewind 

• Berkeley or AT&T mode 

All other configuration options are extended options that result in use of the property table. 

It is recommended that all tape device files be put in the /dev/rmt directory. All tape device files using 
extended configuration options must be put in the /dev/rmt directory. This is required for proper 
maintenance of the property table. Device files using a extended configuration options located outside the 
/dev/rmt directory may not provide consistent behavior across system reboots. 

Use the rmsf(lM) command to clean up unused device files. Otherwise, the property table may overflow 
and cause the mksf (1M) command to fai I. 

Density codes listed in <sys/mtio .h > have device-dependent behaviors. See the hardware manual for 
your tape device to find which densities are valid. For some devices, these values may be referred to as for¬ 
mats instead of densities. 

Use of unbuffered mode can reduce performance and increase media wear. 

Reads and writes from/to older (fixed block) devices such as QIC150 must occur at exact multiples of the 
supported block size. 
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Write operations on a QIC device can be initiated only at bot or eod. QIC devices will not allow writes 
with the tape positioned in the middle of recorded data. 

The offline operation puts the Ql C drive offline. The cartridge is not ejected as is done for dds. To put the 
drive back online, the cartridge has to be manually ejected and then reinserted. 

Sequential-access devices that use the SCSI I/O interface may not always report true media position. 

On a 3480 device with data compression enabled, writing of a single record that cannot be compressed to 
less than 102,400 bytes is not supported. 

Note that using the 8200 format on 8500-style8mm devices will significantly reduce tape capacity, and that 
only the 8500c-density setting provides support for setmarks. 

The maximum I/O request for 8mm devices is limited to 240KB. 

DEPENDENCIES 

Driver-Specific Options for stape (major number 205) 

The following options may be used in creating device special files for tape drives that access the stape 
driver: 

e Exhaustive mode is enabled (default is disabled). 

When exhaustive mode is enabled, the driver will, if necessary, attempt several different 
configuration options when opening a device. The first attempt follows the minor number 
configuration exactly, but if that fails, thedriver attempts other likely configuration values. 

With Exhaustive mode disabled, the driver makes only one attempt to configure a device using the 
configuration indicated in the minor number. 

p Specifies a partitioned tape whose currently active partition is partition 1 (closest to BOT (begin¬ 
ning of tape)). Optional partition 1 is closest to BOT for possible use as a volume directory. The 
default partition without this option is partition 0. If partitioning is unsupported, the entire tape is 
referred to as partition 0. 

s [#] Specifies fixed-block mode; the optional number indicates the block size. If the number is not 
present, thedriver selectsa default block size appropriate to the device type. 

Driver Specific Options for tapeland tape2 (major number 212) 

The foil owing options may be used in creating device special files for tape drives that access the tapel and 
tape2 drivers: 

o Diagnostic messages to the console are suppressed. 

z The tape driver will attempt to mimic the behavior of RTE systems; that is, the driver will not do 
any tape alteration or movement when the device is closed. 

Diagnostic Access Naming Convention (tapel only) 

The following alternative naming convention is used to provide diagnostic access for HP-IB devices only: 

/dev/diag/rmt/c#t#l# 


AUTHOR 

mt was developed by HP and the University of California, Berkeley. 


FILES 

/dev/rmt/* 
/dev/diag/rmt/* 
<sys/mtio.h> 
/etc/mtconfig 
/dev/rmt/*config 


tape device special files 
diagnostic access special files (HP-IB only) 
constants and macros for use with tapes 
configuration property tablefor tapes 

device files for accessing configuration properties table-for internal use only 


SEE ALSO 

dd(l), mt(l), ioctl(2), insf(lM), Issf(lM), mksf(lM), rmsf(lM), 
Configuring HP-UX for Peripherals 
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NAME 

nfs, NFS - network file system 

DESCRIPTION 

The Network File System (NFS) allows a client node to perform transparent file access over the network. 
By using NFS, a client node operates on files residing on a variety of servers and server architectures, and 
across a variety of operating systems. File access calls on the client (such as read requests) are converted 
to NFS protocol requests and sent to the server system over the network. The server receives the request, 
performs the actual file system operation, and sends a response back to the client. 

NFS operates in a stateless manner using remote procedure calls (RPC) built on top of an external data 
representation (XDR) protocol. The RPC protocol enables version and authentication parameters to be 
exchanged for security over the network. 

A server grants access to a specific file system to clients by adding an entry for that file system to the 
server's /etc/exports file. 

A client gains access to that file system using the mount command to request a file handle for the file sys¬ 
tem (see mount(lM)). (A file handle is the means by which NFS identifies remote files.) Once a client 
mounts the file system, the server issues a file handle to the client for each file (or directory) the client 
accesses. If the file is removed on the server side, the file handle becomes stale (dissociated with a known 
file), and the server returns an error with errno set to [ESTALE]. 

A server can also be a client with respect to file systems it has mounted over the network; however, its 
clients cannot directly access those file systems. If a client attempts to mount a file system for which the 
server is an NFS client, the server returns with errno set to [eremote], The client must mount the file 
system directly from the server on which thefilesystem resides. 

The user ID and group ID mappings must be the same between client and server. Flowever, the server 
maps UID 0 (the superuser) to UID -2 before performing access checks for a client. This process prevents 
gaining superuser privileges on remote file systems. 

RETURN VALUE 

Generally, physical disk I/O errors detected at the server are returned to the client for action. If the server 
is down or inaccessible, the client receives the message: 

NFS: file server not responding: still trying. 

The client continues resending the request until it receives an acknowledgement from the server. There¬ 
fore, the server can crash or power down, and come back up without any special action required by the 
client. The client process requesting the I/O will block, but remains sensitive to signals (unless mounted 
with the nointr option) until the server recovers. Flowever, if mounted with the soft option, the 
client process returns an error instead of waiting indefinitely. 

AUTHOR 

nfs was developed bySun Microsystems, Inc. 

SEE ALSO 

exportfs(lM), mount(lM), mount_nfs(lM), nfsd(lM), mount(2), checklist^), exports(4). 
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NAME 

null - null file 

DESCRIPTION 

Data written on a null special file is discarded. 

Reads from a null special file always return 0 bytes. 

EXAMPLES 

To create a zero-length file, use either of the following: 

cat /dev/null > file 
cp /dev/null file 


FILES 

/dev/null 

STANDARDS CONFORMANCE 

null: AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, POSIX.2 
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NAME 

pckt - Packet Mode modulefor STREAMS pty (pseudo-terminal) 

SYNOPSIS 

#include <sys/stropts.h> 

int ioctl(fd_slave, I_PUSH, "pckt"); 

DESCRIPTION 

The Packet Mode feature for STREAMS pty devices allows the user process on the master side of the 
pty device to be informed of state changes in the pty. Toenable Packet Mode in the STREAMS pty dev¬ 
ice, the user process must push the pckt module onto the master side of the pty with a call to the 
STREAMS I_PUSH ioctl (2) system call. When the pckt module is pushed onto a STREAMS pty master, 
certain STREAMS messages going upstream on the master side will get packetized so they can be subse¬ 
quently retrieved by the master side with a getmsg function. 

When the user process writes data, the pckt module passes the message unchanged downstream on to 
the next module or driver. When the user process reads data or when the pckt module receives certain 
STREAMS message types, it constructs a packet out of the message for forwarding upstream. To construct 
a message packet, the module creates an M_PROTO message. This M_PROTO message contains the origi¬ 
nal message type in the first data block and the original message in as many data blocks as needed. The 
user process can then retrieve the M_PROTO message with a call to the getmsg () function. 

The pckt modulepacketizesthefollowing STREAMS message types: 

M_DATA,M_IOCTL,M_PROTO,M_PCPROTO,MFLUSH,M_START,M_STOP,M_STARTI,M_STOPI, 
M_READ. 

All other messages are passed unchanged upstream. 

If the message is an M_FLUSH message, the pckt module looks at the flag and takes the following 
actions: 


• If the flag is FLUSHW, the module changes it to FLUSHR before creating the M_PROTO message 
and passing the message upstream. This prevents the stream head's read queue from being 
flushed by the original M_F LUSH message. 

• If the flag is FLUSHR, the module changes it to FLUSHW before creating the M_PROTO message 
and passing it upstream. To flush the write queues properly, the module also sends an M_FLUSH 
message with the FLUSHW flag set. 

• If the flag is FLUSHRW, the module changes it to FLUSHW before creating the M_PROTO message 
and passing it upstream. To flush the write queues properly, the module also sends an M_FLUSH 
message with the FLUSHW flag set. 


AUTHOR 

pckt (7) was developed by HP and OSF. 

SEE ALSO 

getmsg(2), ioctl(2), ptm(7), pts(7), ldterm(7), ptem(7), streamio(7). 
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NAME 

ps2, ps2kbd, ps2mouse- PS/2 keyboard/mouse device driver and files 

SYNOPSIS 

#include <sys/ps2io.h> 

DESCRIPTION 

Theps2 driver allows the use of IBM Personal System/2 (PS/2) compatible keyboards and mouse devices 
on Hewlett-Packard workstations equipped with PS/2 interface hardware. 

On systems with a single interface, PS/2 devicefile names usethefollowingformat: 

/dev/ps2_n 

where n represents the interface port number, ranging from 0 to 15. For example, the device file 
/dev/ps2_l is used to access port one. 

On systems with more than one interface, PS/2 device file names use thefollowingformat: 

/dev/ps2_m. n 

where m represents the interface number, and n represents the port number. For example, the device file 
/dev/ps2_l. 2 is used to access port two on interface one. 

At boot time, the ps2 driver scans all interface ports from port zero to the maximum number of ports 
implemented and attempts to identify attached PS/2 devices. The /dev/ps2mouse device file accesses 
the first mouse detected by ps2. The /dev/ps2kbd device file accesses the first keyboard detected by 
ps2. 

PS/2 devices are classified as "slow" devices. This means that system calls to ps2 can be interrupted by 
caught signals (see signal (5)). 

The mouse may be placed in one of two output modes. I n stream mode, the mouse generates a three-byte 
report packet in response to mouse movement and/or button presses. These reports can be obtained with 
theread() system call (see read(2)). In prompt mode, an ioctl() request polls the mouse, returninga 
three-byte report packet in a buffer whose address is passed as an argument to the ioctl () call. 

PS/2 keyboards return keycodes that represent key-press and key-release events. Use the I nternal Termi¬ 
nal Emulator (ITE) to read ASCI I characters from PS/2 keyboards. The ASCII terminal interface used by 
thelTE is described in termio(7). 

Theps2 driver provides a low-level programming interface to PS/2 keyboards and mice. To access these 
devices in a hardware independent way, use the X Window programming environment. 

System Calls 

The open () system call gives exclusive access to the specified PS/2 device (see open(2)). If a port is open, 
all open () calls made on that port will fail with errno set to [E BUSY] (see errno(2)). 

If an open is attempted on a nonexistent port, the open () call fails with errno set to [ENXIO], 

If no keyboard is detected at system boot and an open () is attempted on /dev/ps2kbd, or if no mouse 
is detected at system boot and an open () is attempted on /dev/ps2mouse, the open () call fails with 
errno set to [ENXI O], 

Attempts to open an existingps2 port with no device connected will succeed. 

Upon a successful open, any previously queued input from the device is discarded. Keystrokes are routed 
to the ITE by default. While a keyboard is open, ITE does not receive keystrokes from that keyboard; until 
the keyboard device is closed, it has exclusive access to keyboard input. 

The file status flags 0_NDELAY and 0_NONBLOCK can be set to enable nonblocking reads (see open(2)). 

read() returns bytes from a PS/2 device. HP-UX maintains a 512-byte buffer for each port. When this 
buffer is full, additional bytes received from the device are discarded. 

If enough buffered data is availableto satisfy the entire number of bytes requested, the read() call com¬ 
pletes successfully, having read all of the data requested and returning the number of bytes read. 

If there is not enough buffered data availableto satisfy the entire request, but at least one byte is available, 
the read() call completes successfully, having read all availabledata and returning the number of bytes 
actually read. 
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If both file status flags 0_NDELAY and 0_N0NBL0CK are clear and no data is available, the read () call 
blocks until data becomes availableor a signal is received. 

If the file status flag 0_NDELAY is set and no data is available, the read() call returns zero instead of 
blocking. 

If the file status flag O^NONBLOCK is set and no data is available, the read() call returns -1 with 
errno set to [EAGAIN] (see errno(2)). 

The write () system call is not supported by ps2. 

The select () system call can be used to determine if data is currently availableto be read from a ps2 
port. Using select () for write or for exception conditions always returns a false indication in the file 
descriptor bit masks (see select(2)). 

The ioctl () system call is used to perform special operations on PS/2 mouse and keyboard devices (see 
ioctl (2)). The set of ps2 driver ioctl () requests are divided into three groups: general requests to both 
mouse and keyboard, keyboard-specific requests, and mouse-specific requests. Mouse-specific requests used 
on keyboards, and keyboard-specific requests used on mice, fail, returning -1 with errno set to [EIN- 
VAL], 

Any ioctl () request (except PS2_PORTSTAT) used on a port not connected to a PS/2 device will time 
out, returning -1 with errno set to [EIO], 

All ioctl() system calls use thefollowing syntax: 

int ioctl(int fildes, int request, char *arg); 

All requests that require parameters or return data use a 4-byte unsigned character buffer addressed by 
the arg argument. 

The request codes that follow are defined in <sys/ps2io . h>. 

General ioctl() Requests for Both Keyboard and Mouse 

PS2_PORTSTAT Return driver status information. 

Two bytes of data are returned in the character buffer addressed by arg. 

Byte 0, which indicates the type of connected device, can have four possible 
values: 

PS2_NONE No device is detected. 

PS2 MOUSE Mouse is detected. 

PS2_KEYBD Keyboard is detected. 

PS2 UNKNOWN Unknown device is detected. 

Byte 1 contains bit flags for various pieces of driver information. Thefollowing 
bit masks for this byte are defined in the file 
/usr/include/sys/ps2io.h: 

INTERFACE_HAS_ITE If set, the interface containing this port is 

used by the Internal Terminal Emulator 
(ITE) for keyboard input. 

PORT_HAS_FlRST_KEYBD If set, this port is connected to the first 

keyboard detected by the driver. 

PORT HAS FIRST_MOUSE If set, this port is connected to the first 

mouse detected by the driver. 

All other bits are currently unused, and are cleared to zero. 

P S 2_D I SABLE D i sa bl e a P S/2 devi ce. 

Further output from the device is prevented by the device itself. This request 
does not use arg. Certain devices perform actions in addition to disabling 
themselves. 

The keyboard resets its internal state to the default state, stops scanning the 
keys, and waits for further commands. 

The mouse stops transmission of reports, and then disables itself. 
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PS2_ENABLE 

PS2_IDENT 


PS2„SETDEFAULT 


PS2RESET 


Enablea PS/2 device 

Transmissions from the device are enabled. This request does not use arg. 
Identify a PS/2 device. 

A value identifying the type of device is returned in the 4-byte buffer 
addressed by arg. The keyboard returns two bytes (arg[0]=0xAB and 
arg [1] =0x83). The mouse returns one byte (arg [0] =0x00). 

Set the device to its default (power-up) state. 

The device is returned to its default internal state. This request does not use 
arg. 

Reset a PS/2 device. 

The device is told to execute its internal reset routine and execute its power-up 
test. The result of the power-up test is returned in the 4-byte buffer addressed 
by arg. The mouse returns two bytes to indicate a successful reset 
(arg[0]=0xAA and arg[1] =0x00). The keyboard returns one byte 
(arg[0]=0xAA). 


Keyboard-Specific ioctl() Requests 

PS2_SCANCODE Select the keyboard scancode set 

The scancode set to be used by the keyboard is passed as the first byte of the 
buffer addressed by arg. The foil owing are valid values for this byte: 


SCANCODEl 
SCANCODE 2 
SCANCODE3 
GET_SCANCODE 


Selects scancode set 1. 
Selects scancode set 2. 
Selects scancode set 3. 
Returns the scancode used. 


When GET_SCANCODE is specified, the scancode used by the keyboard is 
returned as the first byte of the character buffer addressed by arg. Some key¬ 
boards do not support all scancode sets. 

PS2_ALL_TMAT Set all keys to typematic behavior. 

This request can be made when the keyboard is using any scancode set; how¬ 
ever, it affects only the operation of scancode set 3. The arg parameter is not 
used. The typematic rate and delay are set via the PS2__RATEDELAY 
ioctl() request. 

PS2ALLMK Set all keys to make-only behavior. 

This request can be made when the keyboard is using any scancode set; how¬ 
ever, it affects only the operation of scancode set 3. The arg parameter is not 
used. 


PS2__ALL_MKBRK Set all keys to make/break behavior. 

This request can be made when the keyboard is using any scancode set; how¬ 
ever, it affects only the operation of scancode set 3. The arg parameter is not 
used. 


PS2__ALL_TMAT_MKBRK Set all keys to typematic mak^break behavior. 

This request can be made when the keyboard is using any scancode set; how¬ 
ever, it affects only the operation of scancode set 3. The arg parameter is not 
used. The typematic rate and delay are set via the PS2_RATEDELAY 
ioctl() request. 

PS2_KEY_TMAT Set typematic behavior for an individual key. 

The key code from scancode set 3 for the individual key is passed as the first 
byte in the character buffer addressed by arg. This request can be made when 
the keyboard is using any scancode set; however, it affects only the operation 
of scancode set 3. The typematic rate and delay are set via the 
PS2_RATEDELAY ioctl() request. Because keyboards might be left in a 
disabled state after this request, the PS2_ENABLE request should be 
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performed after PS2_KEY_TMAT. 

PS2_KEY_MAKE Set make-only behavior for an individual key. 

The key code from scancode set 3 for the individual key is passed as the first 
byte in the character buffer addressed by arg. This request can be made when 
the keyboard is using any scancode set; however, it affects only the operation 
of scancode set 3. Because keyboards might be left in a disabled state after 
this request, the PS2_ENABLE request should be performed after 
PS2_KEY_MAKE. 

PS2_KEY_MKBRK Set mak^break for an individual key. 

The key code from scancode set 3 for the individual key is passed as the first 
byte in the character buffer addressed by arg. Mak^break behavior will beset 
for this key. This request can be made when the keyboard is using any scan¬ 
code set; however, it affects only the operation of scancode set 3. Because key¬ 
boards might be left in a disabled state after this request, the PS2_ENABLE 
request should be performed after PS2„KEY_MKBRK. 

PS2 INDICAT0RS Set the state of keyboard indicators, Num Lock, Caps Lock, and Scroll Lock, 

according to the value passed in the first byte of the character buffer addressed 
by arg. 

The indicators are bit-mapped as follows: 

NONE_LED No indicators active 

CAPS LED Caps Lock indicator active 

NUM_LED Num Lock indicator active 

SCROLL_LED Scroll Lock indicator active 

PS2_RATEDELAY Set the rate and delay for all typematic keys by specifying the value passed as 

the first byte in the character buffer addressed by arg. 

Bits zero through four give the rate. Bits five and six give the delay. Bit 
seven (the most significant bit) is unused and should be set to zero. The delay 
in milliseconds is determined by the following equation, where X is the 
numeric value of bits five through six: 

delay = (1+X) * 250 (+| - 20%) 

The period (interval from one output key code to the next) in seconds is deter¬ 
mined by the following equation, where Y is the numeric value of bits zero 
through two, and Z is the numeric value of bits three through four: 

period = (8+Y) * (2~Z) * 0.00417 (+) - 20%) 

The typematic rate (expressed in make codes per second) is one for each period 
using the above equation. The default typematic rate is 10.9 characters per 
second. The default delay is 500 milliseconds. 

Mouse-Specific ioctl() Requests 

PS2_SAMPLERATE Set the mouse sampling rate used in stream mode by specifying the value 

passed as the first byte in the character buffer addressed by arg. 

Seven specific rates are supported: 

SAMPLE_10 10 reports/second maximum 
SAMPLE_20 20 reports/second maximum 
SAMPLE 40 40 reports/second maximum 

SAMPLE_60 60 reports/second maximum 
SAMPLE_80 80 reports/second maximum 
SAMPLE_100 100 reports/second maximum 
SAMPLE_200 200 reports/second maximum 

The default rate is 100 reports/second maximum. This request updates the 
mouse sampling rate only in stream mode. If the mouse is in prompt mode, 
this request is ignored. 

PS2 PROMPTMODE Put mouse into prompt mode. 
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PS2REPORT 


PS2__STRE AMMODE 


PS2_STATUS 


PS2RESOLUTION 


In prompt mode, the mouse updates its internal values due to movement or 
button presses, but issues reports only in response to the PS2_REP0RT 
ioctl () request. The arg parameter is not used. 

Obtain a prompt mode mouse report. 

This request polls the mouse, obtaining a three-byte report returned in the 
character buffer addressed by the arg parameter. The report has the following 
format: 

Byte 1 A bit map of buttons, signs, and overflows 

Bit 0 Left button (l=depressed) 

Bit 1 Right button (l=depressed) 

Bit 2 Center button (l=depressed) 

Bit 3 Always 1 

Bit 4 X data sign (l=negative) 

Bit 5 Y data sign (l=negative) 

Bit 6 X data overflow (l=overflow) 

Bit 7 Y data overflow (l=overflow) 

Byte 2 X-coordinate data byte 
Byte 3 Y-coordinate data byte 

TheXandY coordinate values areexpressed in two's complement. Thescaling 
behavior specified via the PS2_2T01_SCALING ioctl () request does not 
apply to reports obtained with the PS2_REPORT ioctl () request. 
PS2_2T01_SCALING affects only reports sent in stream mode. 

Put mouse into stream mode. 

When in stream mode, the mouse sends a three-byte report whenever the 
mouse is moved, or a button is pressed or released since the last report. The 
maximum report rate is set with the PS2_SAMPLERATE ioctl () request. 
If a button is both pressed and then released within a sample interval, it will 
be reported as pressed at the end of that interval. 

The stream-mode reports are obtained via the read() system call (see 
read(2)). The format of the report is identical to reports returned by the 
PS2 REP0RT ioctl () request descri bed above. 

When in stream mode, the PS2_DISABLE request must be sent prior to any 
other ioctl () requests. 

The arg parameter is not used. 

Obtai n mouse status. 

This request polls the mouse, obtaining a three-byte report returned in the 
character buffer addressed by the arg parameter. 

The status report has the foil owing format: 

Byte 1 A bit map of buttons and mouse internal state 



BitO 

Right button (l=depressed) 


Bit 1 

Center button (l=depressed) 


Bit 2 

Left button (l=depressed) 


Bit 3 

Always 0 


Bit 4 

If 0, scaling 1:1; if 1, scaling 2:1 


Bit 5 

If 0, disabled; if 1, enabled 


Bit 6 

If 0, stream mode; if 1, prompt mode 


Bit 7 

Always 0 

Byte 2 

Current resolution setting 

Byte 3 

Current sampling rate 

Set mouse resolution 

for X and Y coordinate values by specifying the value 

passed as the first byte in the character buffer addressed by arg. Four discrete 


resolutions are supported: 
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PS2_2T01_SCALING 


PS2_1T01_SCALING 


Resolution 

RES_1 

RES_2 

RES_3 

RES_4 


200 DPI 320 DPI 

1 count/mm 1 count/mm 

2 count/mm 3 count/mm 
4 count/mm 6 count/mm 
8 count/mm 12 count/mm 


Set mouse scaling at 2 to 1. The X and Y coordinate values returned in 
stream-mode reports are doubled, except for absolute values less than six, 
which are converted to new values in a nonlinear fashion. The conversion is 
detailed in this table: 


Mouse I nternal Value Converted Value 


0 0 

■H-l ^-1 

+1-2 -H -1 

+|-3 +1 - 3 

+|-4 -H - 6 

+|-5 HH - 9 

All other n 2 * n 


This conversion does not apply to reports obtained via the PS2_REPORT 
ioctl() request. 

The arg parameter is not used. 

Set mouse scaling at lto 1. 

The X and Y values returned in mouse reports are not scaled. This request 
does not use the arg parameter. 


ERRORS 

If a system call fails, as noted above in the DESCRIPTION section errno is set to one of the following 
values: 


[EBUSY] 

[EFAULT] 

[EINTR] 

[EINVAL] 

[EIO] 

[ENODEV] 

[ENXIO] 


The specified PS/2 device is already opened. 

A bad address was detected while attempting to use an argument to a system call. 
A signal interrupted an open () , read() , or ioctl () system call. 

An invalid parameter was detected by ioctl () . 

A hardware or software error occurred while executing an ioctl () system call, 
write () is not implemented for PS/2 devices. 

No device is present at the specified address. 


EXAMPLES 

Assume that fildes is a valid file descriptor for a ps2 port connected to a keyboard. The first example 
blinks the keyboard indicators, selects scancode set 3, and loops forever while printing keycodes. 

#include <sys/ps2io.h> 


unsigned char kbdbuf[4]; /* buffer for ioctl operations */ 
unsigned char inchar; /* keycode read */ 

/* flash the LED indicators */ 

kbdbuf[0] = CAPS_LED | SCROLL LED | NUM LED; /* all on */ 

if ( ioctl( fildes, PS2_INDICATORS, Skbdbuf) < 0) { 
perror("ioctl PS2_INDICATORS failed"); 
exit (1); 

} 

printf("Indicators on\n"); 
sleep (1); 

kbdbuf[0] = NONEJLED; /* all off */ 

if ( ioctl( fildes, PS2_INDICATORS, Skbdbuf) < 0) { 
perror("ioctl PS2_INDICATORS failed"); 
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exit (1) ; 

} 

printf("Indicators off\n"); 

/* use scancode set 3 */ 
kbdbuf[0] = SCANC0DE3; 

if ( ioctl( fildes, PS2_SCANC0DE, Skbdbuf) < 0) { 
perror("ioctl PS2_SCANCODE failed"); 
exit (1) ; 

} 

/* identify our scancode set */ 
kbdbuf[0] = GET_SCANCODE; 

if ( ioctl( fildes, PS2_SCANCODE, Skbdbuf) < 0) { 
perror("ioctl PS2_SCANCODE failed"); 
exit (1) ; 

} 

printf("Keyboard reports it is using scancode set %d\n", 

(unsigned int) kbdbuf[0]); 

/* now, loop forever while printing keycodes */ 
while( 1){ 

read( fildes, Sinchar, 1); 

printf("Keycode: %x\n", (unsigned int)inchar); 

} 

The following example puts the mouse in stream mode, sets the report limit to 80 per second, enables the 
mouse, and then loops forever printing mouse reports. Assume that fildes is a valid file descriptor for a 
ps2 port connected to a mouse. 

#include <sys/ps2io.h> 

unsigned char buf[3]; /* mouse report buffer */ 

unsigned char ioctl_buf[4]; /* mouse ioctl buffer */ 

/* first, disable the mouse */ 
if (ioctl( fildes, PS2_DISABLE) < 0){ 
perror("ioctl PS2_DISABLE failed\n"); 
exit (1) ; 

} 

printf("Mouse disabled\n") ; 

/* Put mouse in stream mode */ 
if (ioctl( fildes, PS2_STREAMMODE) < 0){ 
perror("ioctl PS2_STREAMMODE failed\n"); 
exit (1) ; 

} 

printf("Mouse in stream mode\n"); 

/* set samplerate */ 
ioctl_buf[0] = SAMPLE_80; 

if (ioctl( fildes, PS2_SAMPLERATE, ioctl_buf) < 0){ 
perror("ioctl PS2_SAMPLERATE failed\n"); 
exit (1) ; 

} 

printf("Mouse sample rate set to SAMPLE_80\n"); 

/* Enable mouse */ 

if (ioctl( fildes, PS2_ENABLE) < 0){ 
perror("ioctl PS2_ENABLE failed\n"); 
exit (1) ; 

} 

printf("Mouse enabled. \n") ; 
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for (;;) { 

if (read(fildes, &buf[0], 
perror("Read of report 
return 1; 

} 

if (read(fildes, &buf[l], 
perror("Read of report 
return 1; 

} 

if (read(fildes, &buf[3], 
perror("Read of report 
return 1; 

} 

printf("mouse: 0x%02x, %d 


1 ) != 1 ){ 

byte 1 failed"); 


1 ) != 1 ){ 

byte 2 failed"); 


1 ) != 1 ){ 

byte 3 failed"); 


%d\n", buf[0], buf[1], 


buf[2]); 


AUTHOR 

ps2 was developed by the Hewlett-Packard Company. 

PS/2 and Personal System/2 are registered trademarks of International Business Machines, Incorporated, 
in the U.S. and other countries. 


FILES 

/usr/include/sys/ps2io.h 
/dev/ps2_[0-15] 
/dev/ps2_*.[0-15] 
/dev/ps2mouse 
/dev/ps2kbd 


SEE ALSO 

dose(2), errno(2), fcntl(2), ioctl(2), open(2), read(2), select(2), signal(5), termio(7). 
SoftPC User's Guide 
SoftPC Installation Guide 

Sun System Administrators Guidefor theHP700/ RX 
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NAME 

ptem - STREAMS pty (pesudo-terminal) Emulation module 

SYNOPSIS 

#include <sys/stropts.h> 

int ioctl(fd_slave, I_PUSH, "ptem"); 

DESCRIPTION 

ptem is a STREAMS module that emulates a terminal when used in conjunction with ldterm 
(STREAMS line discipline) and pts (STREAMS slave pty driver). The ptem module normally sits above 
pts and below ldterm. The user process must push the ptem module onto the slave side of the pty 
with a call to the STREAMS I_PUSH ioctl (2) system call before ldterm is pushed, ptem is responsi¬ 
ble for processing all of the terminal ioctl commands that are passed downstream from ldterm or 
from ptm (STREAMS pty master driver). 

ldterm and ptem together provide a real terminal behavior for the STREAMS pty slave. However, 
some of the terminal ioctl commands are ignored and cause only an acknowledgement of the command 
since there is no real terminal or modem in the pty subsystem. I n fact, none of the flags in the c_clfag 
field of the termio or termios structures, (which is used by the TCSETA or TCSETS ioctls, 
respectively), have any effect on the pty except if the baud rate is set to zero. Setting the baud rate to zero 
will have the effect of hanging up the pty connection. Similarly, the parity or delay flags in the c_iflag 
field will not have any effect at all on the pty. 

As a summary, the ptem module performs the foil owing tasks: 

• The following ioctls are processed, if appropriate, and acknowledged by sending an 
MIOCACK message upstream when they are received on ptem's write queue: 

TCSETA, TCSETAW, TCSETAF, TCSETS, TCSETSW, TCSETSF, TCGETA, TCGETS, and 
TCSBRK. 

• Keeps track of the window size needed for the TIOCSWINSZ, TIOCGWINSZ, and JWINSIZE 
ioctls. 

• Upon receiving any other ioctl on its write queue, ptem acknowledges them negatively by 
sending an M_I0CNAK message upstream. 

• Thefollowing ioctls are passed downstream by ptem after they have been processed: 

TCSETA,TCSETAW,TCSETAF,TCSETS,TCSETSW,TCSETSF,TCSBRK,and TIOCSWINSZ. 

• Any M IOCNAK message that is received on ptem's read queue will be freed in case the pckt 
module is not pushed on the ptm and the above ioctls get to the pty master STREAMS head, 
which would then send an M_I0CNAK message downstream. 

• When ptem is opened and all conditions for setting up a controlling terminal are met, it sends an 
M_SETOPTS message (with the SO_lSATTY flag set) upstream to the STREAMS head to allo¬ 
cate a controlling terminal. 

• Upon receiving an M_lOCTL message of type TCSBRK on its read queue, ptem sends an 
M IOCACK message downstream and an M_BREAK message upstream. 

• When an ioctl message is received on its write queue to set the baud rate to zero (eg. TCSETA 
with CBAUD set to BO), ptem sends an M_lOCACK message upstream and a zero-length mes¬ 
sage downstream to be read by the pty master process. 

• When an M_lOCTL message of type TIOCSIGNAL is received on its read queue, ptem sends 
an M IOCACK message downstream and an M_PCSIG message upstream with the signal 
number set to the same value used in the M_lOCTL message. 

• When an M_lOCTL message of type TIOCREMOTE is received on its read queue, ptem sends 
an M IOCACK message downstream and an M_CTL message (with ioc_cmd set to 
MC DO CANON or MC_NO_CANON ) upstream to enable or disable the input processing on 
ldterm. 

• When an M_DELAY message is received on its read or write queue, ptem simply discards the 
message without any action. 

• When an M_lOCTL message of type JWINSIZE is received on its write queue and if the values 
in the jwinsize structure in ptem are not zero, ptem sends an M_IOCACK message 
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upstream with the jwinsize structure. If the values are zero, ptem sends an M_I0CNAK 
message upstream. 

• When an M_I0CTL message of type TIOCGWINSZ is received on its write queue and if the 
values in the winsize structure in ptem are not zero, ptem sends an M_IOCACK message 
upstream with the winsize structure. If the values are zero, ptem sends an M_lOCNAK mes¬ 
sage upstream. 

• When an M_lOCTL message of type TIOCSWINSZ is received in its write queue, ptem saves 
the information passed to it in the winsize structure and sends an M_PCSIG (with the signal 
number set to SIGWINCH) upstream to the pty slave process if the window size is changed. 

• When an M_I0CTL message of type TIOCGWINSZ is received on its read queue and if the 
values in the winsize structure in ptem are not zero, ptem sends an M_I0CACK message 
downstream with the winsize structure. If the values are zero, ptem sends an M__I0CNAK 
message downstream. 

• When an M_lOCTL message of type TIOCSWINSZ is received in its read queue, ptem saves 
the information passed to it in the winsize structure and sends an M_PCSIG (with the signal 
number is set to SIGWINCH) upstream to the pty slave process if the window size is changed. 

• All other messages not mentioned above are passed to the next module or driver. 


AUTHOR 

ptem was developed by H P. 

SEE ALSO 

ioctl (2), streamio(7), ptm(7), pts(7), ldterm(7). 
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NAME 

ptm - STREAMS master pty (pseudo-terminal) driver 

SYNOPSIS 

#include <sys/stropts.h> 

#include <sys/ptyio.h> 

#include <sys/strtio.h> 

int open("/dev/ptmx", 0_RDWR); 

DESCRIPTION 

A pseudo-terminal (pty) consists of a tightly-coupled pair of character devices, called the master device and 
slave device. The pty master and slave device drivers work together to simulate a terminal connection 
where the master provides a connection to the pseudo terminal server process and the slave provides a ter¬ 
minal device special file access for the terminal application processes, as depicted below: 


| pty functions | 

Application <—> |-| <—> Server 

Processes | Slave | Master | Process 

I (pts) | (ptm) | 


The slave driver, pts with ptem (STREAMS pty emulation module) and ldterm (STREAMS line discip¬ 
line module) pushed on top (not shown for simplicity), provides a terminal interface as described in ter- 
mio(7). Whereas devices that provide the terminal interface described in termio(7) havea hardware device 
behind them; in contrast, the slave device has another process manipulating it through the master side of 
the pty. Data written on the master device is given to the slave device as input and data written on the 
slave device is presented as input on the master device. 

I n order to use the STREAMS pty subsystem, a node for the master pty driver /dev/ptmx and N number 
of slave pty devices must be installed (see pts(7) for details on slave pty). There are no nodes in the file sys¬ 
tem for each individual master device. Rather, the master driver is set up as a STREAMS clone driver (see 
done(7)) with its major device number set to the major for the clone driver and its minor device number set 
to the major for the ptm driver. The master driver is opened using the open() system call with 
/dev/ptmx as the device file parameter. The clone open finds the next available minor number for the 
master device. The master device is availableonly if it and its corresponding slave device are not already 
opened. Only one open is allowed on a master device whereas multiple open are allowed on the slave dev¬ 
ice. When the master device is opened, the corresponding slave device is automatically locked out (see 
pts(7) on how to unlock the slave and obtain the slave device name). After both the master and slave have 
been opened, the user has two file descriptors which represent the end points of a full duplex connection 
composed of two streams. These two streams are automatically connected by the master and slave devices 
when they are opened. The user may then push the necessary modules on the master and slave streams 
(e.g., ptem and ldterm, on pts for terminal semantics, and pckt on ptm for Packet Mode feature). 

The master and slave drivers pass all STREAMS messages to their adjacent drivers. Only the M_FLUSH 
message needs some special processing because the read queue of the master is connected to the write 
queue of the slave and vice versa. Hence, the FLUSHR flag is changed to FLUSHW flag and vice versa 
whenever a M_FLUSH message travels across the master-slave link. When the master device is closed, an 
M„HANGUP message is sent to the corresponding slave device which will render that slave device unusable. 
The process on the slave side gets the errno [ENXIO] when attempting a write () system call on the 
slave device but it will be able to read any data remaining on the slave stream. Finally, when all the data 
have been read, the read() system call will return 0 (zero) indicating that the slave can no longer be 
used. On the last close of the slave device, a zero-length M_DATA message is sent to the corresponding 
master device. When the application on the master side issues a read () orgetmsgO system calls and 
a 0 is returned. The user of the master device decides whether to close the master device file which will 
dismantle the streams on the master side. If the master device remains opened, the corresponding slave 
device can be opened and used again by another user. 

Unlike the slave device, the master device does not act like a terminal. If 0_NDELAY or 0_N0NBL0CK is 
set, a read on the master device returns -1 with errno set to [EAGAI N] if no data is available, and a write 
returns -1 with errno set to [EAGAI N] if there is internal flow control on the stream. 

The master ptm driver supports the foil owing ioctl () requests: 
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ISPTM Determines whether the file descriptor is that of an open master device. On success, it 

returns the major and minor number (type dev_t) of the master device which can be used to 
determine the name of the corresponding slave device. On failure, it returns -1 with errno 
set to [EINVAL], ISPTM on HP-UX can return valid device number with negative value. 
For example, with major number of the STREAMS pty master being 0x9c, ICPTM will 
return 0x90000000 which is a negative number. Therefore, it is imperative that applica¬ 
tions check for an explicit -1 instead of "<0" (less than 0) on the return value. 

ISPTM is used by functions grantpt () , unlockpt () , and ptsname () . User appli¬ 
cations normally do not need to invoke this ioctl. The format of this ioctl is: 

int ioctl(master_fd, ISPTM, 0) 

UNLKPT Unlocks the master and the corresponding slave devices. On success, it returns 0. On 
failure, it returns -1 with errno set to [EINVAL], UNLKPT is used by function 
unlockpt () . User applications normally do not need to invoke this ioctl. The format of 
this ioctl is: 

int ioctl(master_fd, UNLKPT, 0) 

TIOCREMOTE This ioctl puts the STREAMS pty in and out of Remote Mode. When Remote Mode is on, 
input data will be flow-controlled and passed through ldterm without any input process¬ 
ing regardless of the terminal mode. When the pty master driver receives this ioctl, it will 
send an M_CTL message downstream to ldterm via ptm, pts, and ptem. The com¬ 
mand in the M_CTL message is set to MC_NO_CANON or MC_DO_CANON depending 
whether to turn on or off the Remote Mode. The format of this ioctl is: 

int ioctl(master_fd, TIOCREMOTE, argument) 

where the argument is set to 1 to turn on Remote Mode and 0 to turn it off. Remote Mode 
is normally used when doing remote line editing in a window manager, or whenever flow- 
controlled input is required. Each write to the master device produces a record boundary 
for the process reading the slave devices. In normal usage, a write of data is likethedata 
typed as a line on the terminal; a write of 0 (zero) bytes is like typing an EOF (End-of-File) 
character. 

TIOCSIGNAL This ioctl allows the master process to send a signal to the slave process. The format of this 
ioctl is: 

int ioctl(master_fd, TIOCSIGNAL, argument) 

where the argument is the signal number as defined in the header file 
<sys/signal .h>. For example the master process can send an SIGINT signal to the 
slave process by doing: 

ioctl(master_fd, TIOCSIGNAL, SIGINT) 


AUTHOR 

ptm was developed by HP and OSF. 

FILES 

/dev/ptmx Streams pty master clone device 

/dev/pts/N Streams pty slave devices (0 <= N < NSTRPTY ), where NSTRPTY is a kernel tunable 
parameter which can be changed via SAM. 


SEE ALSO 

insf(lM), getmsg(2), ioctl(2), open(2), read(2), write(2), grantpt(3C), ptsname(3C), unlockpt(3C), clone(7), 
ldterm(7), pckt(7), ptem(7), pts(7), streamio(7), termio(7). 
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NAME 

pts- STREAMS slavepty (pseudo-terminal) driver 

SYNOPSIS 

#include <sys/stropts.h> 

#include <sys/termios.h> 

#include <sys/strtio.h> 

int open ( "/dev/pts/N", 0_RDWR) ; 

DESCRIPTION 

A pseudo-terminal (pty) consists of a tightly-coupled pair of character devices, called the master device and 
slave device. The pty master and slave device drivers work together to simulate a terminal connection 
where the master provides a connection to the pseudo terminal server process and the slave provides a ter¬ 
minal device special file access for the terminal application processes, as depicted below: 


| pty functions | 

Application <—> |-| <—> Server 

Processes | Slave | Master | Process 

I (pts) | (ptm) | 


The slave driver, pts with ptem (STREAMS pty emulation module) and ldterm (STREAMS line discip¬ 
line module) pushed on top (not shown for simplicity), provides a terminal interface as described in ter- 
mio(7). Whereas devices that provide the terminal interface described in termio(7) havea hardware device 
behind them; in contrast, the slave device has another process manipulating it through the master side of 
the pty. Data written on the master device is given to the slave device as input and data written on the 
slave device is presented as input on the master device. 

I n order to use the STREAMS pty subsystem, a node for the master pty driver /dev/ptmx and N number 
of slave pty devices must be installed (see ptm(7) for more details on master pty). When the master device 
is opened, the corresponding slave device is automatically locked out. No user can open that slave device 
until its permissions are changed (via the grantpt() function) and the device is unlocked (via the 
unlockpt() function). The user then call theptsname () function to obtain the name of the slave dev¬ 
ice and invoke the open () system call to open the slave device. Although only one open is allowed on a 
master device, multiple opens are allowed on the slave device. After both the master and slave have been 
opened, the user has two file descriptors which represent the end points of a full duplex connection com¬ 
posed of two streams that are automatically connected by the master and slave devices when they are 
opened. The user may then push the desired modules (for example, ptem and ldterm, on pts for ter¬ 
minal semantics and pckt on ptm for Packet Mode feature). 

The master and slave drivers pass all STREAMS messages to their adjacent drivers. Only the M__FLUSH 
message needs some special processing because the read queue of the master is connected to the write 
queue of the slave and vice versa. For example, the FLUSHR flag is changed to FLUSHW flag and vice 
versa whenever a M_FLUSH message travels across the master-slave link. When the master device is 
closed, an M_HANGUP message is sent to the corresponding slave device which will render that slave device 
unusable. The process on the slave side gets the errno [ENXIO] when attempting a write () system call 
to the slave device file but it will be able to read any data remaining in the slave stream. Finally, when all 
the data has been read, theread() system call will return 0, indicating that the slave can nolongerbe 
used. On the last close of the slave device, a zero-length M_DATA message is sent to the corresponding 
master device. When the application on the master side issues a read(2) or getmsg(2) system calls, a 0 
(zero) is returned. The user of the master device may decide to close the master device file, which disman¬ 
tles the stream on the master side. If the master device remains opened, the corresponding slave device 
can be opened and used again by another user. 

EXAMPLES 

The foil owing example shows how a STREAMS pty master and slave devices are typically opened. 

int fd_master, fd_slave; 

char *slave; 


fd_master = open("/dev/ptmx", 0_RDWR) ; 
grantpt(fd_master); 
unlockpt(fd_master) ; 
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slave = ptsname(fd_master); 
fd_slave = open(slave, 0_RDWR); 
ioctl(fd_slave, I_PUSH, "ptem"); 
ioctl(fd_slave, I_PUSH, "ldterm"); 


AUTHOR 

pts was developed by HP and OSF. 

FILES 

/dev/ptmx Streams pty master clone device 

/dev/pts/N Streams pty slave devices (0 <= N < NSTRPTY ), where NSTRPTY is a kernel tunable 
parameter which can be changed via SAM (seesam(lM)). 

SEE ALSO 

insf(lM), sam(lM), getmsg(2), ioctl(2), open(2), read(2), write(2) : grantpt(3C), ptsname(3C) : unlockpt(3C), 
ldterm(7), ptem(7), ptm(7), streamio(7), termio(7). 
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NAME 

pty - pseudo terminal driver 

DESCRIPTION 

The pty driver provides support for a device-pair termed a pseudo terminal. A pseudo terminal is a pair of 
character devices, a master device and a slave device. The slave device provides to application processes an 
interface identical to that described in termio(7). Unlike all other devices that provide the interface 
described in termio(7), the slave device does not have a hardware device behind it. I nstead, it has another 
process manipulating it through the master half of the pseudo terminal. Thus anything written on the 
master device is given to the slave device as input, and anything written on the slave device is presented as 
input on the master device. 


| pty functions | 

Application <—> |-| <—> Server 

Processes | Slave | Master | Process 

I (pts) | (ptm) | 


Open and Close Processing 

The slave side of the pty interprets opening or closing the master side as a modem connection or discon¬ 
nection on a real terminal. Only one open to the master side of a pty is permitted. An attempt to open an 
already open master side returns -1 and sets the external variable errno to [EBUSY], An attempt to 
open the master side of a pty that has a slave with an open file descriptor returns -1 and sets errno to 
[EBUSY], The potential problem of ptys being found busy at opens can be avoided by using the clone open 
functionality discussed in the next section. 

An attempt to open a nonexistent pty returns -1 and sets errno to [ENXIO], If 0„NDELAY is not 
specified, opens on the slave side hang until the master side is opened. If O^NDELAY is specified, opens on 
the slave side return error if the master side is closed. Any ioctl () or write () request made on the 
slave side of a pty after the master side is closed returns -1 and sets the external variable errno to 
[EIO], A read () request made on the slave side of a pty after the master side is closed returns 0 bytes. 
Closing the master side of a pty sends a SIGHUP hangup signal to the tty process group number of the 
corresponding slave side and flushes pending input and output. 

Clone Open 

I n typical pty usage, there is no preference among pty pairs. Thus, it is useful to be able to issue a single 
open() that internally opens any availablepty. An open on /dev/ptym/clone returns an open file 
descriptor of a free master pty device. If there are no free devices, the open returns -1 and sets errno 
to [EBUSY], The name of the slave device corresponding to the opened master device can be found through 
a ptsname () request. 

Processing ioctl() Requests 

By default, any ioctl () request defined by termio(7) is recognized by both the master and slave sides of 
a pty. These ioctl () requests are processed by the pty driver as specified by termio(7). In addition, 
the ioctl () requests defined below are recognized by the master side of a pty. The slave side only 
recognizes ioctl () requests defined by termio(7). An ioctl () request made on the slave side of a pty 
after the master side is closed returns -1 and sets the external variable errno to [EIO], An ioctl () 
request not recognized by the pty returns -1 and sets the external variable errno to [EINVAL], Note 
that some of the master-side-only ioctl () requests affect which ioctl () requests are recognized by 
the master and slave side of the pty. These master-side-only ioctl () requests also affect the way 
recognized ioctl () requests, open() requests, and close () requests are processed by the pty 
driver. 

The foil owing ioctl () requests, defined in <sys/ptyio .h>, apply only to the master side of pty: 
TIOCSIGSEND 

Cause a signal to be sent from the slave side of the pty to the current tty process group of 
the slave side. The value of the parameter is taken to be the signal number sent. An [ElN- 
VAL] error is returned and no signal is sent if the specified signal number does not refer to 
a legitimate signal (see signal (5)). Note that this request allows the server process to send 
signalsto processes not owned by thesameuser ID. 

TIOCTTY Enable or disable all termio processing by a pty. termio processing is enabled if the 
int addressed by arg is nonzero and disabled if the int addressed by arg is zero. By 
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default, termio processing is enabled, termio processing refers to processing of input 
and output described by termio(7) (such as tab expansion), as well as the processing of the 
ioctl() requests described by termio(7). When disabled, all input and output data is 
passed through the pty without modification. Issuing a TIOCTTY ioctl() request 
flushes all data buffered in the pseudo terminal and releases any processes blocked waiting 
for data. Enabling and disablingTlOCTTY affects the operation of thefollowing ioctl () 
requests: TIOCPKT, TIOCREMOTE, TIOCBREAK, TIOCSTOP, TIOCSTART, TIOC- 
TRAP,and TIOCMONITOR. 

When TIOCTTY is enabled, all termio ioctl () requests execute as specified in ter- 
mio(7), regardless of the side from which the ioctl () request is made. When TIOCTTY 
is disabled, master side termio ioctl () requests set and return the the external vari¬ 
able errno to [El NVAL], Slave side termio ioctl() requests are processed like any 
other ioctl () request when TIOCTTY is disabled. In particular, slave side termio 
ioctl () requests set and return the external variable errno to [El NVAL] when both 
TIOCTTY and TIOCTRAP are disabled. (See the discussion of ioctl () , open() , and 
closet) trapping below). ioctl() requests not defined by termio(7) are not affected by 
the state of TIOCTTY. 

Data written through a pseudo terminal with TIOCTTY disabled is handled in a manner 
similar to data flowing through a pipe. A write request blocks in thepty until all data has 
been written into the pty. A read request blocks if there is no data available unless the 
0_NDELAY flag is set (see fcntl (2)). When data is availableto be read, the read request 
returns whatever is available, and does not wait for the number of bytes requested to be 
satisfied. The number of bytes a pty can contain in its internal memory is implementation 
dependent, but is at least 256 bytes in each direction. For example, a write on the slave 
side of a pty of 1024 bytes might be read on the master side by four read requests return¬ 
ing 256 bytes each. The size of the chunks of data that are read is not guaranteed to be 
consistent, but no data is lost. 

The following ioctl () requests, defined in <sys/ptyio .h>, apply only to the master side of a pty. 
In particular, these ioctl () requests enable/disable specific modes of pty driver operation. These 
ioctl () requests work in series with TIOCTTY; that is, the mode must be enabled by its ioctl () 
request and TIOCTTY must be enabled for the mode to operate. The mode can be enabled or disabled 
regardless of the state of TIOCTTY. 

TIOCPKT Enable or disable packet mode. Packet mode is enabled if the int addressed by arg is 
nonzero and disabled if the int addressed by arg is zero. By default, packet mode is dis¬ 
abled. When applied to the master side of a pseudo terminal, each subsequent read() 
from the master side returns data written on the slave part of the pseudo terminal pre¬ 
ceded by a zero byte (symbolically defined as TlOCPKT_DATA), or a single byte reflecting 
control status information. The value of such a status byte is composed of zero or more bit 
flags: 

TIOCPKT_FLUSHREAD 

The read queue for the slave side has been flushed. 

TIOCPKTFLUSHWRITE 

The write queue for the slave side has been flushed. 

TIOCPKTSTOP 

Data flowing from the slave side of the pty to the master side has been stopped by 
means of ~s, tiocstop, or tcxonc. 

TIOCP KT_S TART 

Data flowing from the slave side of thepty to the master side has been restarted. 

TIOCPKTDOSTOP 

Stop and start characters have been set to ~S or "Q. 

TIOCPKTNOSTOP 

Stop and start characters are set to something other than ~S or ~Q. 

TIOCREMOTE Enable or disable remote mode. Remote mode is enabled if the int value of arg is nonzero 
and disabled if the int value of arg is zero. By default, remote mode is disabled. Remote 
mode is independent of packet mode. This mode causes input to the pseudo terminal to be 
flow controlled and not input edited (regardless of the terminal mode). Each write to the 
master side produces a record boundary for the process reading the slave side. I n normal 
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usage, writing data is like typing the data as a line on a terminal; writing zero bytes is 
equivalent to typing an end-of-file character (that is, the EOF character as defined in ter- 
mio(7)). The data read by the slave side is identical to the data written on the master side. 
Data written on the slave side and read on the master side with TIOCREMOTE enabled is 
still subject to the normal termio(7) processing. TIOCREMOTE can be used when doing 
remote line editing in a window manager, or whenever flow-controlled input is required. 
Issuing a TIOCMONITOR ioctl () request flushes all data buffered in the pseudo termi¬ 
nal. 

The following ioctl () requests, defined in <sys/ptyio. h>, apply only to the master side of pty. I n 
particular, these ioctl () requests are only recognized when TIOCTTY is enabled. When TIOCTTY is 
disabled, these ioctl () requests set and return the external variableerrno to [El NVAL], 

TIOCBREAK Cause a break operation to be done on the slave side of the pty, as if a user had pressed 
the break key on a real terminal. Takes no parameter. 

TIOCSTOP Stop data flowing from the slave side of the pty to the master side (equivalent to typing 
A S). Takes no parameter. 

TIOCSTART Restart output (stopped by TIOCSTOP or by typing ~S). Takes no parameter. 

Flow-Control Input and Output Processing 

The following terms are used to describe the flow of data through pseudo terminals. INPUT refers to data 
flowing from the master side of a pty to the slave side. OUTPUT refers to data flowing from the slave side 
of a pty to the master side. 

When packet mode (TIOCPKT) is disabled and INPUT is stopped (see IXOFF, input modes, in termio(7)), 
the next read () from the master side of a pty returns a STOP character. When INPUT is restarted, the 
nextread() from the master side returns a START character. If packet mode (TIOCPKT) is enabled, the 
STOP or START character is preceded by a data packet indicator (TIOCPKTDATA). select () should be 
used by the master-side server before each write () request to properly handle INPUT flow control (see 
select(2)). 

When INPUT flow control is enabled, write () andselect() are handled as follows: Write-selects on 
the master side of a pty return true only if INPUT has not been stopped. If INPUT becomes stopped 
while data is being written into the master side of a pty, the write returns with the number of bytes writ¬ 
ten before INPUT was stopped. Writes done after INPUT is stopped return immediately with zero bytes 
written. 

When packet mode (TIOCPKT) is disabled and OUTPUT is stopped (see IXON, input modes in termio(7)), 
each subsequent read () from the master side of a pty returns with no data read. When OUTPUT is res¬ 
tarted, each subsequent read() from the master side returns data written on the slave side. If packet 
mode (TIOCPKT) is enabled, the first read () after OUTPUT has been stopped returns a TIOCPKTSTOP 
packet. All subsequent reads from the master side while OUTPUT is stopped returns a TIOCPKTDATA 
packet with no data. When OUTPUT is restarted, the next read() from the master side returns a 
TIOCPKTSTART packet. All subsequent reads from the master side return data written on the slave side 
preceded by a TIOCPKTDATA packet, select () should be used by the master-side server before each 
read() to properly handle OUTPUT flow control. Otherwise, reads from the master side of a pty will 
not be prevented when OUTPUT is stopped. 

Trapping ioctl(), open(), close() Requests 

When trapping is enabled, the master side is notified when the application on its slave side makes an 
ioctl () , open () , or close () request. For trapped ioctl () andopen() requests, the slave side 
is blocked (that is, the request does not complete) until the server on its master side acknowledges the 
trapped request. For trapped close () requests, the slave slave does not block for an acknowledgement. 

select () should be used by the master side server to receive notification of trapped ioctl () , 
open () , and close () requests. When one of these requests is trapped, the select () returns with an 
"exceptional condition" indicated for the slave side's file descriptor. Other mechanisms for receiving 
notification of trapped requests are defined below, but these mechanisms should be used only if select () 
is not available. 

When trapping is disabled (default condition), unrecognized slave ioctl () requests return an error, with 
the external variableerrno set to [El NVAL], The only ioctl () requests recognized by the slave side 
are those defined by termio(7) and only when TIOCTTY is enabled. When TIOCTTY is disabled, no 
ioctl () requests are recognized by the slave side. If trapping is enabled and the master side closes, 
trapping is disabled. If the master closes during the middle of a handshake with the slave, the handshake 
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is done automatically. 

Trapping occurs in two forms that are identified by the ioctl () requests that enable or disablethem — 
TIOCTRAP and TIOCMONITOR. These two forms are distinguished by the types of requests they affect 
and by the capabilitiesthey provide. Trapping open () and close () requests is enabled or disabled by 
TIOCTRAP . Trapping ioctl () requests not defined by termio(7) areenabled or disabled by TIOCTRAP. 
Trapping ioctl () requests defined by termio(7) are enabled or disabled by TIOCTRAP only when 
TIOCTTY is also disabled. When TIOCTTY is enabled, trapping ioctl () requests defined by termio(7) 
areenabled or disabled by TIOCMONITOR. Briefly, both TIOCTRAP and TIOCMONITOR trapping allow 
the server on the master side to examine the request's parameters, the pid making the request, etc. In 
addition, TIOCTRAP trapping allows the server to modify the parameters and return values of an 
ioctl () request. 

The following ioctl () calls apply only to the master side of a pty and pertain to trapping ioctl () , 
open () , and close () requests. They are defined in <sys/ptyio .h>: 

TIOCTRAP Enable or disable trapping of ioctl () , open() , and close () requests made by the 
application on the slave side of a pty. Trapping is enabled if the int addressed by arg is 
nonzero and disabled if the int addressed by arg is zero. By default, TIOCTRAP trapping 
is disabled. 

TIOCTRAPSTATUS 

Check for a pending ioctl () , open () , or close () trap. The argument points to an 
int that is set to one if a trap is pending and to zero if nothing is pending. Use TIOC¬ 
TRAPSTATUS when the preferred method of a select () "exceptional condition" is not 
available. 

TIOCREQCHECK 

Return the trapped ioctl () , open () , or close () information to the master side. Use 
TIOCREQCHECK in response to either a select () "exceptional condition" or a TIOC¬ 
TRAPSTATUS indicating that a trap is pending. A TIOCREQCHECK reads the pending 
ioctl () , open () , or close () information into the memory pointed to by the arg of 
TIOCREQCHECK. The information takes the form of the following request_info 
structure, defined in <sys/ptyio .h>: 


struct request_info { 
int request; 
int argget; 
int argset; 
short pgrp; 
short pid; 
int errno_error; 
int return_value; 


All elements of request_info refer to the slave side of the pty and include the follow¬ 
ing: 

request The ioctl () command received. 

argget The ioctl () request applied to master side to receive the trapped 
ioctl () structure, if one exists (a zero value means there is none). 
(When nonzero, argget is a TIOCARGGET request with the size field 
precomputed.) 

argset The ioctl () request applied to master side to send back the resulting 
ioctl () structure, if one exists (a zero value means there is none). 
(When nonzero, argset is a TIOCARGSET request with the size field 
precomputed.) 


pgrp The process group number of the process doing the operation, 

pid The process ID of the process doing the operation. 


errno_error 

The errno external variable error code (initialized to zero) returned by 
ioctl () on the slave side. When open error mode is enabled, 
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errno_error can be used to return an error for trapped slave pty 
open() requests. See the discussion of the TIOCSMODES ioctl() for 
further information on open error mode. 

return_value 

The success value (initialized to zero) returned by ioctl () on the slave 
side when errno_error is not set. 

When the ioctl () argument received on the slave side is not a pointer, 
its value is stored as four bytes retrievable with an ioctl () request to 
the master side equal to argget. 

When an open() or close () is being passed, request is set to 
TIOCOPEN or TIOCCLOSE, respectively. For TIOCOPEN and TIOC- 
CLOSE, both argget and argset are zero because there is no 
ioctl () structure. When TIOCTTY is enabled, the termio(7) definition 
of open/close is executed first before being passed to the master side. Note 
that whileall opens are trapped, only the last close on a particular inode for 
apty slavesideistrapped bythepty. 

A TIOCREQCHECK returns the external variable errno error [EINVAL] 
if no ioctl () , open() , or close () trap is pending. Accordingly, a 
TIOCREQCHECK that returns [EINVAL] in response to a select () 
"exceptional condition" indicates that the trapped ioctl () , open() , or 
close () request was terminated by a signal after select () returned. 

TIOCREQGET Identical to TIOCREQCHECK except when no ioctl () , open() , or close () trap is 
pending. A TIOCREQGET blocks until a slave side ioctl () , open() , or close () is 
trapped; whereas a TIOCREQCHECK returns [El NVAL], Use TIOCREQGET when neither 
the preferred method of a select () "exceptional condition" nor the master side 
ioctl () tioctrapstatus isavailable. 

TIOCREQSET Complete the handshake started by a previous TIOCREQCHECK or TIOCREQGET. The 
argument should point to the request_info structure, as defined by the 
TIOCREQCHECK. 

Before doing this ioctl () request to complete the handshake, the server should set 
errno_error to an external variable errno error value to be passed back to the slave 
side. If there is no error, errno_error can be left alone because the pty initializes it to 
zero. Also, when there is no error, return_value should be set if other than a zero 
result is desired. The server can set return_value and errno_error if the trapped 
request is an ioctl () and may set errno_error for a trapped open () if open error 
mode is enabled. Setting either return_value or errno_error for a trapped 
close () affects neither the return value of the request nor the external variableerrno 
value of the slave side. Setting either return_value or errno_error for a trapped 
open () affects neither the return value of the request nor the external variable errno 
value of the slave side unless open error mode is enabled. Open error mode allows the 
server to return an error to a trapped slave open () by setting errno_error . Unlike 
ioctl () requests, setting return_value never affects slave pty open() requests. 
Further, setting either return_value or errno_error does not cause TIOCREQSET 
to return an error to the server. 

If the TIOCREQSET request is made and the request value in the passed 
request_info structure does not equal the trapped value, the external variableerrno 
is set and returned as [EINVAL], [EINVAL] is also returned if there are no trapped 
ioctl () , open() , or close () requests. If the trapped request has been interrupted 
by a signal between the time that the server has done the TIOCREQGET and the 
TIOCREQSET, the TIOCREQSET request returns [EINVAL], 

TIOCGFLAGS Get the file status flags associated with a trapped request. Upon successful return, the 
ioctl () returns in an integer referenced by arg the file status flags for the trapped 
request. The flag definitions in <sys/file .h> can be used to interpret the flags. If no 
trap is currently pending, the TIOCGFLAGS ioctl () returns an error with the external 
variableerrno set to [EINVAL], 

TIOCMONITOR 

Enable or disable read-only trapping of termio ioctl () requests. TIOCMONITOR 
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trapping is enabled if the int addressed by arg is nonzero and disabled if the int 
addressed by arg is zero. By default, TIOCMONITOR trapping is disabled. TIOCMONI- 
TOR works in series with TIOCTTY ; that is, the TIOCMONITOR trapping must be enabled 
and TIOCTTY must be enabled for termio ioctl () requests to be trapped by TIOC¬ 
MONITOR. TIOCMONITOR trapping can be enabled or disabled regardless of the state of 
TIOCTTY. 

When TIOCTTY is disabled, termio ioctl () requests are not trapped by TIOCMONI¬ 
TOR. However, ioctl () requests are trapped by TIOCTRAP if TIOCTTY is disabled 
and TIOCTRAP is enabled. TIOCTRAP trapping allows the master side server to modify 
the parameters and return values of an ioctl () request, whereas TIOCTMONITOR 
trapping does not. 

TIOCMONITOR trapping allows the server on the master side to know when characteris¬ 
tics of the line discipline in the pty are changed by an application on its slave side. The 
mechanism for handshaking termio requests trapped by TIOCMONITOR is the same as 
the mechanism described above for requests trapped by TIOCTRAP . (It is recommended 
that termio ioctl () requests be used on the master side to interrogate the configured 
state of the line discipline in the pty. This compensates for the window of time before 
TIOCMONITOR is enabled, when termio ioctl () requests are not trapped.) 

When using select () on the master side of a pty, the "exceptional condition" refers to an open() , 
close () , or ioctl () request pending on the slave side, while "ready for reading or writing" indicates 
that the device can be read from or written to successfully. 

Of the ioctl () requests subject to being trapped, only one-per-pty can be handled at a time. This means 
that when an application does a non-termio ioctl () request to the slave side, all other ioctl () 
requests to the same pty slave side are blocked until the first one is handshaked back by the master side, 
(ioctl () requests that are not trapped, such as termio when TIOCTTY is enabled and TIOCMONI¬ 
TOR is disabled, are not blocked.) This permits the implementation of indivisible operations by an 
ioctl () call on the slave side that is passed to the server process. 

In summary, the following method of handling trapped ioctl () , open() , and close () requests is 
preferred: 

1. Call select() . This system call blocks the master side until a slave side ioctl () , open() , 
or close () request is trapped. 

2. Make TIOCREQCHECK ioctl () request. This step returns information about a trapped 
ioctl () , open() , or close () request. If TIOCREQCHECK returns the external variable 
errno error [EINVAL], loop back to the select () call. 

3. Make argget ioctl () request. This optional step is used if argget is nonzero and the 
server wants to do more than just reject the trapped slave ioctl () request. 

4. Make argset ioctl () request. This optional step is done if argset is nonzero and the 
server wants to pass back a modified ioctl () structure. It is done after the trapped 
ioctl () request is processed via the server on the master side. 

5. Set errno_error and return_value . If the trapped request is an ioctl (), set 
errno_error appropriately. If the appropriate value for errno_error is zero, 
return_value must be set. If open error mode is enabled, set errno_error to a nonzero 
value to return an error to a trapped open () request. 

6. Make TIOCREQSET ioctl () request. This step completes the trapped ioctl (), open () , 
or close () request. 

While a process is waiting in the slave side of the pty for the server to complete a handshake, it is suscep- 
tibleto receiving signals. The following master sideioctl () request allows the server process to control 
howthepty responds when a signal attempts to interrupt a trapped open () or ioctl() request: 

TIOCSIGMODE 

Set the signal handling state of thepty to the mode specified as the argument. The mode 
can have three values, which are TIOCSIGBLOCK , TIOCSIGABORT , and TIOCSIGNOR- 
MAL. 

TIOCSIGBLOCK 

Cause some signals to be postponed that are destined for the slave-side process whose 
open() or ioctl () request is trapped. Signals are postponed if they would 
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otherwise cause the process to jump to an installed signal handler. Signals are not 
postponed if they would otherwise cause the process to abort or if they are being 
ignored. When the server process completes the handshake by means of the 
TIOCREQSET ioctl () request, the process returns to the calling program and any 
pending signals are then acted upon. Any signalsthat the user has blocked by means 
ofsigblock() continues to be blocked. 

TIOCSIGABORT 

Prevent a trapped open() or ioctl () request from being restarted. The server 
process sets this mode when it wants the interrupted requests to return to the calling 
program with an [El NTR] error. 

TIOCSIGNORMAL 

This is the default mode of the pty. If a signal interrupts a trapped open() or 
ioctl () request, the user's signal handler routine can specify whether the request 
is to be restarted. If the request is restarted, it executes again from the beginning 
and the server has to make another TIOCREQGET request to start the handshake 
over again. If the user's signal handler routine specifies that the interrupted request 
should not be restarted, the request returns to the calling program with [ElNTR] 
upon completion of the signal handler. Note that the restarted request is not neces- 
sari ly the very next one to be trapped. 

The following ioctl () requests, defined in <sys/ptyio .h>, providea mechanism to get and set pty 
modes. Five of the modes can also be manipulated using other ioctl () requests discussed previously. 
See the bit definitions for the ioctl () equivalents. The effect of enabling or disabling them by either 
means is identical. Commonly, an application would use the TIOCGMODES ioctl () to get the pty 
modes currently in effect, set or clear the bits for the modes being changed, and issue a TIOCGMODES 
ioctl () to effect the desired change. 

TIOCGMODES Get the pty modes currently in effect. The ioctl () returns in a long referenced by arg 
bits indicating the states of various pty modes. If a bit is set, the associated mode is 
enabled. If a bit is clear, the associated mode is disabled. Unused bits are clear. The 
meaning of the bits is described under the description of the TIOCSMODES ioctl () . 

TIOCSMODES Set thepty modes according to the value of type long referenced by arg. Unused bits are 
ignored but should be set to zero. The bit values for pty modes are listed below. 

PM_REMOTE 

Enable or disable remote mode. See the discussion of the TIOCREMOTE ioctl() . 
PM_TTY 

Enable or disable tty mode. See the discussion of the TIOCTTY ioctl() . 

PMPKT 

Enable or disable packet mode. See the discussion of the TIOCPKT ioctl() . 
PMTRAP 

Enableor disabletrap mode. See the discussion of the TIOCTRAP ioctl(). 
PMMONITOR 

Enable or disable monitor mode. See the discussion of the TIOCMONITOR 
ioctl(). 

PM_OPEN_ERROR 

Enable or disable open error mode. Open error mode allows a server process to 
return an error to a trapped slave pty open() through the TIOCREQSET 
ioctl () . When open error mode is enabled, the server may return a trapped 
open () with an error by setting the errno_error field in the request_info 
structure passed to theTIOCREQSET ioctl () . When open error mode is disabled 
(the default state), setting errno_error to handshake a slave open() has no 
effect. Note that unlike the ioctl () trap handshaking, setting return_value 
has no effect for a slave open () regardless of the state of open error mode. See the 
discussion of the TIOCREQSET ioctl () for further details on handshaking a 
trapped request. 


WARNINGS 

The slave side cannot indicate an end-of-file condition to the master side. 
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When using TIOCREMOTE, a single write () request to the master side of greater than 256 bytes may 
result in multi pie smaller records being read from the slave side instead of only one record. 


AUTHOR 

pty was developed by the University of California, Berkeley. 


FILES 

/dev/ptym/pty[a-ce-z][0-9][0-9] 
/dev/ptym/pty[a-ce-z][0-9][0-9][0-9] 
/dev/ptym/pty[a-ce-z][0-9a-f] 
/dev/pty[pqr][0-9a-f] 

/dev/pty/tty[a-ce-z][0-9][0-9] 
/dev/pty/tty[a-ce-z][0-9][0-9][0-9] 
/dev/pty/tty[a-ce-z][0-9a-f] 

/dev/tty[pqr][0-9a-f] 


master pseudo terminals 
master pseudo terminals 
master pseudo terminals 
master pseudo terminals 
slave pseudo terminals 
slave pseudo terminals 
slave pseudo terminals 
slave pseudo terminals 


SEE ALSO 

dose(2), fcntl(2), ioctl(2), open(2), read(2), select(2), sigblock(2), write(2), ptsname(3C), signal(5), termio(7). 
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NAME 

routing - system support for local network packet routing 

DESCRIPTION 

The network facilities for HP-UX provide general packet routing support. Routing table maintenance is 
handled by application processes. 

A routing table consists of a set of data structures used by the network facilities to select the appropriate 
remote host or gateway when transmitting packets. The table contains a single entry for each route to a 
specific network or host, as displayed by the netstat command with the -r or -rn options (see 
netstat(l)). Routes that are not valid are not displayed. 


# netstat -r 
Routing tables 


Destination 

Gateway 

Flags 

Refs 

Use 

Interface 

Pmtu 

hpindwr.cup.hp. 

com 







localhost 

UH 

1 

39 

loO 

4608 

localhost 

localhost 

UH 

0 

68 

loO 

4608 

147.253.56.195 

localhost 

UH 

0 

0 

loO 

4608 

147.253.144.66 

localhost 

UH 

0 

0 

loO 

4608 

default 

hpinsmh.cup.hp. 

com 







UG 

1 

21 

lanO 

1500 

15.13.136 

hpindwr.cup.hp. 

com 







u 

1 

92 

lanO 

1500 

147.253.56 

147.253.56.195 

u 

0 

7 

lan2 

1500 

147.253.144.64 

147.253.144.66 

u 

0 

7 

lanl 

1500 


# netstat -rn 
Routing tables 


Destination Gateway 

15.13.136.66 127.0.0.1 

127.0.0.1 127.0.0.1 

147.253.56.195 127.0.0.1 

147.253.144.66 127.0.0.1 

default 15.13.136.11 

15.13.136.0 15.13.136.66 

147.253.56.0 147.253.56.195 

147.253.144.64 147.253.144.66 

Flags 

UH 

UH 

UH 

UH 

UG 

U 

U 

U 

Refs 

1 

0 

0 

0 

2 

1 

0 

0 

Use 

39 

68 

0 

0 

30 

113 

7 

7 

Interface 

loO 

loO 

loO 

loO 

lanO 

lanO 

lan2 

lanl 

Pmtu 

4608 

4608 

4608 

4608 

1500 

1500 

1500 

1500 

# netstat -rv 

Routing tables 

Dest/Netmask Gateway 

Flags 

Refs 

Use 

Interface 

Pmtu 

hpindwr.cup.hp.com/Oxffffffff 
localhost 

UH 

1 

39 

loO 

4608 

localhost/Oxffffffff 

localhost 

UH 

0 

68 

loO 

4608 

147.253.56.195/Oxffffffff 
localhost 

UH 

0 

0 

loO 

4608 

147.253.144.66/0xffffffff 
localhost 

UH 

0 

0 

loO 

4608 

default/OxOOOOOOOO 

hpinsmh.cup.hp. 

com 

UG 

2 

31 

lanO 

1500 

15.13.136/0xfffff800 

hpindwr.cup.hp. 

com 

U 

1 

129 

lanO 

1500 

147.253.56/0xfffffeOO 

147.253.56.195 

u 

0 

7 

lan2 

1500 

147.253.144.64/0xfffffff0 

147.253.144.66 

u 

0 

7 

lanl 

1500 
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# netstat -rnv 
Routing tables 
Dest/Netmask Gateway 
15.13.136.66/255.255.255.255 
127.0.0.1 
127.0.0.1/255.255.255.255 
127.0.0.1 

147.253.56.195/255.255.255.255 

127.0.0.1 

147.253.144.66/255.255.255.255 
127.0.0.1 

default/0.0.0.0 15.13.136.11 
15.13.136.0/255.255.248.0 

15.13.136.66 

147.253.56.0/255.255.254.0 

147.253.56.195 
147.253.144.64/255.255.255.240 

147.253.144.66 


Flags 

Refs 

Use 

Interface 

Pmtu 

UH 

1 

39 

loO 

4608 

UH 

0 

68 

loO 

4608 

UH 

0 

0 

loO 

4608 

UH 

0 

0 

loO 

4608 

UG 

3 

40 

lanO 

1500 

U 

1 

153 

lanO 

1500 

U 

0 

8 

lan2 

1500 

U 

0 

8 

lanl 

1500 


The foil owing columns are of particular interest: 


Destination 


Netmask 


Gateway 

Flags 


Interface 


The destination Internet address: host name, network name, or default. The 
default keyword indicates a wildcard route, used as a last resort if no route is 
specified for a particular remote host or network. See Flags. 

The netmask and the destination I nternet address together define a range of IP 
addresses that may be reached by the route's gateway. A host route by default 
has a netmask of all l's. A default route by default has a netmask of all 0's. The 
netmask is also used in selecting a route to forward an I P packet, (see Routing 
Algorithm.) 

The gateway to use to get to the destination: remote gateway or the local host. 
See Flags. 

The type of route: 

U The route is "up" or available(see ifconfig(lM)). 

G The route uses a remote host as a gateway; otherwise, the local host is 

shown as the gateway (see route(lM)). 

H The destination is a host; otherwise, the destination is a network (see 
route(lM)). 

The interface connections: 


loO The local loopback after system boot-up. 

lanO, lanl,... The interface cards installed on the local host after 
the ifconfig command is executed at boot time 
(see ifconfig(lM)). 

The values of the count and destination type fields in the route command determine the presence of the G 
and H flags in the netstat -r display and thus the route type, as shown in the foil owing table. 


Count 

Destination Type 

Flags 

Route Type 

=0 

network 

u 

Route to a network directly from the local host 

>0 

network 

UG 

Route to a network through a remote host gateway 

=0 

host 

UH 

Route to a remote host directly from the local host 

>0 

host 

UGH 

Route to a remote host through a remote host gateway 

=0 

default 

U 

Wildcard route directly from the local host 

>0 

default 

UG 

Wildcard route through a remote host gateway 


Subnets 

The network facilities support variable-length subnetting. An I nternet address is made up of a network 
address portion, and a host address portion of an address of theform: 

192.34.17.0 
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Subnet addresses are defined as a portion of the network's I nternet address. This scheme provides for: 

• Network addresses that identify physically distinct networks. 

• Subnet addresses that identify physically distinct subnetworks of the same network. 

A network manager can subdivide the Internet address of the local network into subnets using the host 
number space. Thisfacility allows several physical networks to share a single I nternet address. 

To allow for this, three Internet classes are defined, each accommodating a different amount of network 
and host addresses. The address classes are defined by the most significant bit of the binary form of the 
address. 

The foil owing table lists the number of networks, nodes, and the address ranges for each address class: 

Nodes per 


Class 

Networks 

Network 

Address Range 

A 

127 

16777215 

0.0.0.1 - 127.225.225.254 

B 

16383 

65535 

128.0.0.1- 191.255.255.254 

C 

2097151 

255 

192.0.0.1 - 223.244.244.243 

Reserved 

— 

— 

224.0.0.0- 255.255.255.255 


The first 8 bits of a Class A network has network space for only 127, while accommodating the largest 
number of nodes possibleamong the classes defined. A singleclass B network has the network address lim¬ 
itation of 16 bits, and 16 bits to define the nodes. 

For example, a Class C address space is as follows: 

Indicates Class C 

Class C subnet 

networks portion 

_l _ I 

10000000 . 00000110 . 00000001.11100001 


Network Address Host 

= 192.6.1 Address 

= 1 


A subnet for a given host is specified with theifconfig command (see ifconfig(lM)), using the netmask 
parameter with a 32-bit subnet mask. 

The default masks for the three classes of Internet addresses are as follows: 

Class A: 255.0.0.0 
Class B: 255.255.0.0 
ClassC: 255.255.255.0 

An example Class C network number is 192.34.17.0. The last field specifies the host number. Thus, all 
hosts with the prefix 192.34.17 are recognized as being on the same logical and physical network. 

If subnets are not in use, the default mask used is 255.255.255.0. 

If subnets are used and the 8-bit host field is partitioned into 3 bits of subnet and 5 bits of host as in the 
above example, then the subnet mask would be 255.255.255.192. 

If a host has multiple interfaces, then it can belong to different subnets. Unlike the past releases, the sub¬ 
nets can have different sizes even if they may have the same network address. This is accomplished by 
using a different netmask on each of the host interfaces. For example, the lanl and Ian2 interface shown in 
the netstat tables above are connected to two distinct subnets of the same network, 147.253. The subnet 
that lanl belongs to can have at most 14 hosts, because its netmask is 255.255.255.240. Note, the host por¬ 
tion of those IP addresses in the subnet cannot be all l's or all 0’s, therefore this subnet cannot support 16 
hosts, but only 14 hosts instead. The subnet that Ian2 belongs to can have up to 510 hosts, because its net- 
mask is 255.255.254.0. 

Supernets 

A supernet is a collection of smaller networks. Supernetting is a technique of using the netmask to aggre¬ 
gate a collection of smaller networks into a supernet. This technique is particularly useful for class C net¬ 
works. A Class C network can only have 254 hosts. This can be too restrictive for some companies. For 
these companies, a netmask that only contains a portion of the network part can be applied to the hosts in 
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these class C networks to form a supernet. This supernet netmask should be applied to those interfaces 
that connect to the supernet using the ifconfig command (see ifconfig(lM)). For example, a host can 
configure its interface to connect to a class C supernet, 192.6, by configuring an IP address of 192.6.1.1 and 
a netmask of 255.255.0.0 to its interface. 

Routing Algorithm 

The routing table entries are of three types: 

• Entries for a specific host. 

• Entries for all hosts on a specific network. 

• Wildcard entries for any destination not matched by entries of thefirst two types. 

To select a route for forwarding an i P packet, the network facilities select the complete set of "matching" 
routing table entries from the routing table. A routing table entry is considered a match, if the result of the 
bit-wise AND operation between the netmask in the routing entry and the IP packet's destination address 
equals to the destination address in the routing entry. 

The network facilities then select from the set the routing entries that have the longest netmask. The 
length of a netmask is defined as the number of contiguous 1 bits starting from the leftmost bit position in 
the 32-bit netmask field. In other words, the network facilities select the routing entry that specifies the 
narrowest range of IP addresses. For example, the host route entry that has a destination/netmask pair of 
(147.253.56.1, Oxffffffff), is more specific than the network route entry that has a destination/netmask pair 
of (147.253.56.0, OxfffffeOO), therefore the network facilities select the host route entry. The default route by 
default has a destination/netmask pair of (0,0). Therefore the default route matches all destinations but it is 
also the least specific. The default route will be selected only if there is not a more specific route. 

There may still be multiple routing entries remaining. In that case the IP packet is routed over the first 
entry displayed by netstat -r. Such multiple routes include: 

• Two or more routes to a host via different gateways. 

• Two or more routes to a network via different gateways. 

• Two default routes. 

A superuser can change entries in the table by using the route command (see route(lM), or by informa¬ 
tion received in Internet Control Message Protocol (ICMP) redirect messages. 

WARNINGS 

Reciprocal route commands must be executed on the local host and the destination host, as well as all 
intermediate hosts, if routing is to succeed in the cases of virtual circuit connections or bidirectional 
datagram transfers. 

AUTHOR 

routing was developed by the University of California, Berkeley. 

FILES 

/etc/hosts 
/etc/networks 

SEE ALSO 

netstat(l), ifconfig(lM), route(lM). 
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NAME 

sad - STREAMS Administrative Driver 

SYNOPSIS 

#include <sys/types.h> 

#include <sys/conf.h> 

#include <sys/sad.h> 

#include <stropts.h> 

int ioctl(int tildes, int command, ... /* arg */) ; 

DESCRIPTION 

The sad driver provides an interface to the autopush facility using the ioctl() function. As an 
interface, the sad driver enables administrative tasks to be performed on STREAMS modules and drivers. 
By specifying the command parameter to the ioctl () function, an administrator can configure auto¬ 
push information for a device, get information on a device, or check a list of modules. 

tildes is a file descriptor obtained by opening /dev/sad using open () . command specifies the adminis¬ 
trative function to be performed, arg points to a data structure. If command is SAD_SAP or SAD_GAP, 
arg points to a struct of type strapush. If command is SADJVML, arg points to a struct of type 
str_list. 

ioctl Commands 

The commands used to perform administrative functions on a STREAMS module or driver are specified by 
thefollowing ioctl () commands: 

SAD_SAP Allows the superuser to configure autopush information for a device. The arg parame¬ 
ter points to a strapush structure (defined in the <sys/sad.h> header file), whose 
members are as follows: 

struct strapush { 
uint sap_cmd; 
long sap_major; 
long sap_minor; 
long sap_lastminor; 
long sap_npush; 

char sap_list[MAXAPUSH][FMNAMESZ+1]; 

} ; 


sap_cmd Allows you to specify the type of configuration to perform. This field can 
have thefollowing values: 

Configures all minor devices. 

Configures a range of minor devices. 

Configures a single minor device. 

Clears the previous settings. Specify only the 
sap_major and sap_minor fields when using 
this command. If a previous entry specified 
SAP_ALL, set the sap_minor field to 0 (zero). If a 
previous entry was specified as SAP_RANGE, set the 
sap_minor field to the lowest minor device number 
in the range. 

sap_ma jor Specifies the major device number. 
sap_minor Specifies the minor device number. 
sap_lastminor Specifies the range of minor devices. 

sap_npush Specifies the number of modules to push. This number must be no more 
than MAXAPUSH, which isdefined in <sad.h>. Additionally, this number 
must not exceed NSTRPUSH. 

sap_list Specifies, in order, the array of modules to push. 


SAP„ALL 
SAP_RANGE 
SAP ONE 
SAP_CLEAR 
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SAD_GAP Lets you use the sad driver to obtain autopush configuration information for a device 
by setting the sap_ma jor and sap_minor fields of the strapush structure (see the 
SAD_SAP command) to the major and minor device numbers of the device being queried. 

arg should point to a struct of type strapush. Upon successful completion, the stra¬ 
push structure contains all of the information used to configure the device. Values of 0 
(zero) will appear in any unused entry in the module list. 

SADJVML Enables you to check a list of modules. For example, you can determine if a specific module 
has been installed. The arg parameter points to a str_list structure (defined in the 
<stropts . h> header file), whose members are as follows: 

struct str_list { 
int sl__nmods; 

struct str_mlist *sl_modlist; 

} ; 

sl_nmods Specifies the number of entries you have allocated in an array. 

sl_modlist Points to the array of module names. The str_mlist structure (also in 
the <stropts .h> header file) is as follows: 

struct str__mlist { 
char l_name[FMNAMESZ+1]; 

} ; 

where l_name specifies the array of module names. 

If the l_name array is valid, the SADJVML command returns a value of 
0 (zero). If the array contains an invalid module name, the command 
returns a value of 1. U pon failure, the command returns a value of -1. 


Notes 

As a STREAMS driver, sad also supports the normal STREAMS I_STRioctl() : 

int ioctl(fildes, I_STR, strp); 
int fildes; 

struct strioctl *strp; 

In this form, specify the ic_cmd field in the strioctl structure to either SADJSAP, SADJSAP, or 
SAD_VML. The ic_dp field points to the strapush structure (see the SADJSAP command in the 
DESCRIPTION section). Refer to thestreamio(7) reference page for further details. 

RETURN VALUE 

U nless specified otherwise, upon successful completion, the sad ioctl () commands return a value of 0 
(zero). Otherwise, a value of -1 is returned. 


ERRORS 

If any of thefollowing conditions occur, the sad ioctl commands return the corresponding value: 


SADSAP 


[EEXIST] 

[E FAULT] 
[EINVAL] 

[ENODEV] 

[ENOSR] 
[ENOSTR] 
[E RANGE] 


The specified major/minor device number pair 
(sadjrta jor/sad_minor) has already been configured. 

The arg parameter points outside the allocated address space. 

The major device number (sad_major ) is invalid, the number of modules 
(sap_list [MAXAPUSH] [FMNAMESZ+1] ) is invalid, or the list of 
module names is invalid. 

The device is not configured for autopush. This value is returned from a 
SAD_GAP command. 

A internal autopush data structure cannot be allocated. 

The major device does not represent a STREAM S driver. 

The sap_lastminor field is less than the sap_minor field when the 
command is SAP_RANGE, or the minor device specified in a SAP__CLEAR 
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command does not exist. 

[EACCES] Only superuser is allowed to execute the SAD_SAP ioctl. 

SAD_GAP 

[E FAULT] Thearg parameter points outside the allocated address space. 

[El NVAL] The major device number (sad_major ) is invalid. 
[ENODEV] The device is not configured for autopush. 

[ENOSTR] The major device does not represent a STREAMS driver. 

SAD VML 

[E FAULT] Thearg parameter points outside the allocated address space. 

[El NVAL] The list of module names is invalid. 

SEE ALSO 

autopush(lM), ioctl(2), open(2), streamio(7). 
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NAME 

scsi - Small Computer System I nterface device drivers 

DESCRIPTION 

The Small Computer System Interface (SCSI) is an American National Standard for interconnecting com¬ 
puters and peripheral devices. HP-UX supports the SCSI device protocol on parallel SCSI interfaces (see 
ANSI Std X3.131-199X, "SCSI -2") and Fibre Channel interfaces (see ANSI Std X3.269-199X, "Fibre Channel 
Protocol for SCSI"). The SCSI standard includes specifications for a variety of device types. This section 
describes the general SCSI interface for all SCSI device drivers. Information about specific device types 
can be found in the manual sections which describe SCSI peripheral device drivers for those device types. 

The SIOC INQUIRY ioctl is supported by all SCSI device drivers. This ioctl returns the SCSI device¬ 
specific INQUIRY command data. This data contains device identification and capability information. 
Since there have been multiple versions of the SCSI standard for inquiry data, multiple versions of the 
inquiry data declaration are provided. The SCSI-1 version is provided for backward compatibility only. 

The SI0C_CAPACITY ioctl indicates the current device size. A device size is defined to be a logical block 
size and some number of logical blocks. The means of determining this device-size data is particular to the 
specific device type. Logical block size and/or number of logical blocks equal to zero indicates: the device 
size is unknown, the device is not currently capableof I/O operations, or I/O operations are not meaningful 
for the device. Note that DI0C_CAPACITY is preferred (see disk(7)). 

The header file <sys/scsi .h > has useful information for SCSI devices. The following is included from 
<sys/scsi .h>: 

#define SIOC_INQUIRY __IOR('S', 2, union inquiry_data) 

fdefine SIOC_CAPACITY _IOR('S', 3, struct capacity) 

/* SCSI-1 inquiry structure */ 


struct inquiry { 



unsigned 

char 

dev_type; 

unsigned 

int 

rmb:1; 

unsigned 

int 

dtq: 7 ; 

unsigned 

int 

iso: 2 ; 

unsigned 

int 

ecma: 3; 

unsigned 

int 

ansi:3; 

unsigned 

int 

resv:4; 

unsigned 

int 

rdf: 4 ; 

unsigned 

char 

added_len; 

unsigned 

char 

dev_class[3]; 

char 


vendor_id[8] ; 

char 


product_id[16] ; 

char 


revnum[4]; 

unsigned 

char 

vendor_spec[20]; 

unsigned 

char 

resv4[40] ; 

unsigned 

char 

vendor_parm_bytes[32] 


); 

/* SCSI-2 inquiry structure */ 


struct inquiry_2 
unsigned 

{ 

int 

periph_qualifier:3 

unsigned 

int 

dev_type:5; 

unsigned 

int 

rmb:1; 

unsigned 

int 

dtq: 7; 

unsigned 

int 

iso: 2 ; 

unsigned 

int 

ecma: 3; 

unsigned 

int 

ansi:3; 

unsigned 

int 

aenc:1; 

unsigned 

int 

trmiop:1; 

unsigned 

int 

resvl:2; 

unsigned 

int 

rdf: 4 ; 

unsigned 

char 

added_len; 

unsigned 

char 

resv2[2]; 

unsigned 

int 

reladr:1; 

unsigned 

int 

wbus32:1; 
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unsigned 

int 

wbusl6:1; 

unsigned 

int 

sync: 1; 

unsigned 

int 

linked:1; 

unsigned 

int 

resv3:1; 

unsigned 

int 

cmdque:1; 

unsigned 

int 

sftre:1; 

char 


vendor_id[8]; 

char 


product_id[16]; 

char 


revnum[4]; 

unsigned 

char 

vendor_spec[20]; 

unsigned 

char 

resv4[40]; 

unsigned 

char 

vendor_parm_bytes[32] ; 


}; 

/* union for SIOC_INQUIRY ioctl */ 
union inquiry data { 

struct inquiry inql; /* SCSI-1 inquiry */ 

struct inquiry_2 inq2; /* SCSI-2 inquiry */ 

}; 

/* structure for SIOC_CAPACITY ioctl */ 
struct capacity { 
int lba; 

int blksz; 

}; 

The SI0C_XSENSE ioctl returns detailed information about device status and errors when such informa¬ 
tion is available. Since there have been multiple versions of the SCSI standard for sense (status) data, mul¬ 
tiple versions of the sense data declaration are provided. The SCSI-1 and non-aligned versions are pro¬ 
vided for backward compatibility only. If no new CHECK-CONDITION-caused REQUEST SENSE com¬ 
mand data has been obtained since the last SlOC_XSENSE ioctl call, the 
xsense_aligned.error_class and sense_2_aligned.error_code fields will contain the 
value zero. Applications which require more accurate REQUEST SENSE data handling should use the 
SCSI device-control driver (see scsi_ctl (7)). 

The following information isincluded from <sys/scsi.h>: 

#define SIOC_XSENSE _IOR('S', 7, union sense_data) 

/* structure for SIOC_XSENSE ioctl */ 
union sense^data { 

struct xsense_aligned r_sensela; /* SCSI and CCS devices */ 
struct sense 2_aligned r_sense2a; /* SCSI-2 devices */ 

>; 

/* structure for SCSI-1 and SCSI-CCS sense data */ 
struct xsense_aligned { 


unsigned 

int 

valid:1; 

unsigned 

int 

error_class:3; 

unsigned 

int 

error_code:4; 

unsigned 

char 

seg_num; 

unsigned 

int 

parms:4; 

unsigned 

int 

sense_key:4 ; 

unsigned 

char 

lba[4]; 

unsigned 

char 

add_len; 

unsigned 

char 

copysearch[4]; 

unsigned 

char 

sense_code; 

unsigned 

char 

resv; 

unsigned 

char 

f ru; 

unsigned 

char 

field; 

unsigned 

char 

field_ptr[2]; 

unsigned 

char 

dev_error[4] ; 

unsigned 

char 

misc_bytes[106] 

structure for 

SCSI-2 

sense data */ 
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struct sense_2_aligned 
unsigned int 
unsigned int 
unsigned char 
unsigned int 
unsigned int 
unsigned int 
unsigned int 
unsigned int 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 


{ 

info_valid:1; 
error_code:7 ; 
seg_num; 
filemark:1; 
eom: 1; 
ili:1; 
resv:1; 
key:4; 
info [4]; 
add_len; 
cmd_info[4]; 
code ; 

qualifier; 
f ru; 

key_specific[3] ; 
add_sense_bytes[113]; 


ERRORS 

The following errors may result from a call to a SCSI device driver: 


[EACCES] 

[ENXIO] 

[EINVAL] 

[EBUSY] 

[EIO] 


Required permission is denied for the the device or operation. 

If resulting from an open call, this indicates there is no device at the specified address. 
For other calls, this indicates the specified address is out of range or the device may 
no longer be accessed. 

If resulting from an open call, this indicates the device is not supported by the device 
driver (e.g. incorrect device type). For other calls, this indicates the request or some 
request argument is invalid. 

This indicates the device is not ready for use or that the requested operation conflicts 
with other operations (e.g. the device is currently open via another device driver or 
exclusive access is in effect). 

Indicates a SCSI protocol or communication problem has occurred, or that a SCSI 
command resulted in a non-good status. 


Manual entries that describe specific SCSI peripheral device drivers may provide additional qualification of 
error results. 


WARNINGS 

Use of devices that are not officially supported can cause data loss, system panics and device damage. H P- 
UX device drivers expect devices to be SCSI-2 compliant. Unsupported devices that are only SCSI-CCS 
compliant may work but their use is discouraged. Use of unsupported devices that are only SCSI-1 compli¬ 
ant is strongly discouraged. 

Changing SCSI bus connectivity (recabling) whilethe system is running is not supported. Switching SCSI 
device power on or off while the device is connected to a system that does not support powerfail recovery is 
not supported. These activities are known to cause data loss and system panics. 

On systems that support the scsi_ctl interface, the SlOC__CMD__MODE, SlOC_SET_CMD , and 
SIOC RETURNSTATUS ioctls are obsolete (see scsi ctl (7)). Direct manipulation of SCSI devices via the 
scsi_ctl interface provides a more functionally complete and easier-to-use means of low level SCSI dev¬ 
ice control (see scsi_ctl (7)). 

Drivers that support only devices which have no meaningful size may not support the SI0C_CAPACITY 
ioctl. Total devicesizein bytes may exceed 2 32 -lfor some devices. 

DEPENDENCIES 

sd i sk/sc h gr/sfl op/stape 

The S IOC_EXCLU S IVE ioctl may be used to obtain and release exclusive access. Exclusive access, which 
prevents simultaneous access by other applications, is required for some operations and may be desirable in 
other circumstances. The following exclusive access control arguments are supported: 
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0 Release exclusive access to logical unit(LUN). 

1 Gain exclusive access to logical unit(LUN). 

2 Release exclusive access to associated SCSI target. 

3 Gain exclusive access to associated SCSI target. 

4 Release exclusive access to associated SCSI bus. 

5 Gain exclusive access to associated SCSI bus. 

The SI0C_MEDIUM_CHANGED ioctl indicates when the media in a removable-media device may have 
changed. A value of "1" indicates the device media may have changed since the last 
SIOC MEDIUM CHANGED ioctl call. Note that only the first such call after a media change receives this 
indication. This means that media changes are likely to be missed if multiple applications are attempting 
to detect media changes. Exclusive access, obtained through use of the SI0C_EXCLUSIVE ioctl, can be 
used to avoid this problem. 

The following information isincluded from <sys/scsi.h>: 

#define SIOC_MEDIUM_CHANGED _IOR('S', 42, int) 

#define SIOC_EXCLUSIVE _IOR('S', 68, int) 


disc3 

The SIOCVPDINQUIRY ioctl allows access to detailed device specific information. The page_code 
field specifies which SCSI vital product data page is requested. The page_buf field is filled with the 
requested page data. 

The following information isincluded from <sys/scsi.h>: 

#define SIOC_VPD_INQUIRY _IOWR('S', 10, struct vpd_inquiry) 

/* union for SIOC__VPD_INQUIRY ioctl */ 
struct vpd_inquiry { 

char page_code; /* VPD page code */ 

char page_buf[126]; /* buffer for VPD page info */ 


FILES 

/usr/include/sys/scsi.h 


SEE ALSO 

diskinfo(lM), ioctl(2) autochanger(7), scsi_ctl(7), scsi_disk(7), scsi_tape(7). 
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NAME 

scsi_ctl - SCSI pass-through driver 

DESCRIPTION 

SCSI devices are controlled by a device-specific driver, when one exists. Device-specific drivers, such as 
those for SCSI direct access (disk) and sequential access (tape) devices, coordinate device and driver states 
to accomplish correct logical device behavior. Thescsi_ctl pass-through driver enables use of SCSI dev¬ 
ices and commands not normally supported by these device-specific drivers. 

Depending on the minor number, a successful open () call by scsi_ctl might or might not require the 
device exist and respond to a SCSI Inquiry command. Once open, ioctl () calls can be used to change 
SCSI communication parameters or attempt SCSI commands and other SCSI operations. Since scsi_ctl 
does not attempt to logically understand the target device, read() andwrite() calls are not supported. 

Except where noted, the ioctls described here are available through all SCSI device drivers (including 
device-specific drivers). Super-user privileges or device write permissions are required to use these ioctls. 
All reserved fields in the data structures associated with these ioctls must be zero-filled. 

Special Device File Minor Number 

The scsi_ctl driver is the preferred method to perform the SIOC IO ioctl, rather than going through a 
device-specific driver (such as sdisk). To do this, you must create the device special file for scsi_ctl. 
Use mknod(lM), substituting the values in the minor number as noted: 

/usr/sbin/mknod name c 203 OxiitlOo 
where component parts of the minor number are constructed as follows: 

ii Two hexadecimal digits, identifying the controlling interface card by its "Instance" number. 
The Instance value is displayed in ioscan(lM) output, under column I for the "Interface" 
hardware type. 

t One hexadecimal digit identifying the drive (target) address. 

I One hexadecimal digit identifying the logical unit number (LUN) within thedevice. 

0 Hexadecimal digit zero, for reserved portion of the minor number. 

o Optional values as follows: 0 to perform Inquiry on open to ensure the device exists (recom¬ 
mended); or 2 to inhibit I nquiry on open. 

SCSI Communication Parameters 

hp-ux supports the SCSI devi ce protocol on parallel SCSI interfaces and FibreChannel interfaces. The SCSI 
communication parameters described here might only apply to certain SCSI interfaces and are noted as 
such in the descriptions. 

SCSI communication parameters control features related to communication for three different scope levels: 
bus (link), target, and logical unit number (LUN). Bus communication parameters apply to all targets con¬ 
nected to a specific bus. Target communication parameters apply to all luns associated with a specific tar¬ 
get. lun communication parameters apply to a specific lun. SCSI communication parameters apply to all 
device drivers (both device-specific and scsi_ctl). 

At power-up and after being reset, all parallel SCSI devices and hosts communicate using asynchronous 
data transfers. Asynchronous data transfers use request (REQ) and acknowledge (ACK) signaling. The strict 
ordering of reQ and ack signalingsimplifiesthecommunication protocol but Iimits I/O performance. A SCSI 
target and host pair may agree to use synchronous data transfers to increase I/O performance. Synchro¬ 
nous data transfers improve I/O performance by lessening the ordering requirements on reqs and acks. By 
allowing multiple outstanding reqs, signal propagation delays and temporary rate imbalances are better 
tolerated. To make use of synchronous data transfers, a SCSI target and host must negotiate to determine 
mutually acceptable maximum REQ-ACK-offset and data-transfer rate parameters. The maximum req- 
ACK-offset parameter indicates the maximum allowable number of outstanding reqs. The value zero is 
used to indicate asynchronous data transfer. Other values indicate synchronous data transfer. The 
appropriate value is generally dependent on the size of the receive data FIFO. High values tend to improve 
data transfer rates. The maximum data-transfer rate parameter indicates the "burst" data transfer rate 
(minimum allowable time between successive synchronous data transfers). A SCSI synchronous data 
transfer request (SDTR) message, used to initiate the negotiation process, is associated with the processing 
of a SCSI command. 

At power-up and after being reset, all parallel SCSI devices and hosts communicate using eight-bit data 
transfers. A SCSI target and host pair may agree to use sixteen-bit (wide) data transfers to increase I/O 
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performance. To make use of wide data transfers, a SCSI target and host must negotiate to determine a 
mutually acceptable data transfer width parameter. A SCSI wide data transfer request (wdtr) message, 
used to initiatethe negotiation process, is associated with the processing of a SCSI command. 

Some SCSI devices are able to simultaneously manage multiple active commands. Such a device has a com¬ 
mand queue that holds commands for processing. Command queuing can improve I/O performance by 
reducing the time spent by the device waiting for new commands from the host. Note that command queu¬ 
ing might not improve I/O performance substantially for devices that support "read-ahead" and 
"immediate-reporting" (see scsi_disk(7) and scsi_tape(7)). The SCSI device and host use command tags to 
correctly manage these multiple simultaneously active commands. At all times when command queuing is 
in effect, each active command being handled by a specific lun has a unique command tag. 

SCSI devices indicate their ability to support the special communication features described above in their 
SCSI inquiry command data. Normally the SCSI inquiry command data and negotiation protocols allow 
hosts and devices to determine the optimal communication parameters so that I/O performance is maxim¬ 
ized. The current operating communication parameters may be determined by use of the: 
SIOCGETLUNPARMS, SIOC_GET_TGT_PARMS, and SIOC_GET BUS._P ARMS ioctls. 

Occasionally, it is desirableto limit SCSI communication parameters to work around a communication prob¬ 
lem or to provide external insight in determining optimal parameters. SCSI communication parameter limit 
suggestions can be specified by use of the: SI0C_SET_LUN_LIMITS, SI0C_SET_TGT_LIMITS, and 
SIOCSETBUSLIMITS ioctls. Note that there might be substantial differences between specified com¬ 
munication parameter limit suggestions and the corresponding actual current communication parameters 
being used for communication. These differences are a result of device-specific driver capabilities, interface 
driver capabilities, interface hardware capabilities, device capabilities, delays due to the negotiation pro¬ 
cess, delays due to currently active commands, and delays due to commands waiting to be sent to devices. 
Note that communication parameter limit suggestions might not survive between close () and open () 
calls, when no SCSI device drivers (device-specific or scsi_ctl) have associated lun (s) open. 

The current SCSI communication parameter limit suggestions may be determined by use of the 

SIOC GET LUN LIMITS, SIOC_GET„TGT_LIMITS, and SIOC_GET_ BUS_LIMITS ioctls. 

Logical unit communication parameters may be managed by use of the SlOC_GET_LUN_PARMS, 
SIOC_SET LUN LIMITS , and SIOCGET LUN LIMITS ioctls. 

The SIOCGETLUNPARMS ioctl indicates the current lun communication parameter values. The 
max_q_depth field indicates whether or not tagged queuing is enabled, and if enabled, the maximum 
number of simultaneously active commands allowed. When max_q_depth is zero, tagged queuing is dis¬ 
abled. When it is one, tags are being used but commands are still being serially processed. When it is 
greater than one, tags are being used and max_q_depth specifies the maximum number of simultane¬ 
ously active commands allowed. 

The SI OC_SE TLUNL IMI T S ioctl may be used to provide lun communication parameter limit sugges¬ 
tions. The max_q_depth field indicates whether or not tagged queuing should be enabled, and if 
enabled, the maximum number of simultaneously active commands that should be allowed. The 
SI OCGETLUNL IMI TS ioctl indicates the current lun communication parameter limit suggestions. 

Target communication parameters may be managed by use of the SlOC_GET_TGT_PARMS, 
siocsettgtlimits, and s Ioc_GET_TGT_L imiT s ioctlsto any associated LUN. 

The SI OCGE TTGTP ARMS ioctl indicates the current target communication parameter values. The 
width, reqack_offset, and xfer_rate fields indicate the currently negotiated data transfer 
parameters. When width is eight, narrow transfers are in effect. When it is sixteen, wide transfers are in 
effect. When reqack_of f set is zero, asynchronous transfers are in effect and xfer_rate is meaning¬ 
less. When reqack_of f set is non-zero, synchronous transfers are in effect and the maximum "burst" 
data transfer rate is xfer_rate words per second, where the size of a word is as indicated in width. 

The SI0C_SET_TGT_LIMITS ioctl specifies the target communication parameter limit suggestions. The 
max_width field specifies maximum bus width that should be used for data transfers. The 
max_reqack_offset field specifies the maximum number of outstanding REQs that should be 
attempted during data transfers. The max_xfer_rate field specifies the maximum "burst" data rate 
that should be allowed during synchronous data transfers. The SI0C_GET_TGT_LIMITS ioctl indicates 
the current target communication parameter limit suggestions. The width, reqack_offset, 
xfer_rate, max_width, max_reqack_offset, max_xfer_rate fields only apply to parallel 
SCSI. 

Bus communication parameters may be managed by use of the SlOC_GET_BUS_PARMS, 
sioc_set_bus_limits, and s i ocge TBUSL imi T s ioctlsto any associ ated LUN. 
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The SIOC_GET_BUS_Parms iodl indicates the current bus communication parameter values. The 
max_width field indicates the maximum data transfer width that will be attempted for data transfers to 
any target device connected to the associated bus. The max_reqack_of f set field indicates the max¬ 
imum number of outstanding reqs that will be attempted during data transfers to any target device con¬ 
nected to the associated bus. The max_xfer_rate field indicates the maximum “burst” data transfer 
rate that will be attempted for data transfers to any target device connected to the associated bus. 

The SI0C_SET_BUS_LIMITS ioctl specifies the bus communication parameter limit suggestions for tar¬ 
gets connected to the associated bus. The max_width field specifies the suggested maximum data 
transfer width that should be attempted for data transfers to any target device connected to the associated 
bus. Themax_reqack_of f set field specifies the maximum number of outstanding REQs that should be 
attempted during data transfers to any target device connected to the associated bus. The 
max_xfer_rate field specifies the maximum synchronous “burst” data transfer rate that should be 
attempted for data transfers to any target device connected to the associated bus. The 
SIOC_GEt_buS_LIMIT s ioctl indicates the current bus communication parameter limit suggestions. 
Themax_width, max_reqack_of f set and max_xf er_rate fields only apply to parallel SCSI. 

The following is included from <sys/scsi .h>: 

/* SCSI communication parameter ioctls */ 

#define SIOC_GET_LUN_PARMS _IOR('S', 58, struct sioc_lun_parms) 

#define SIOC_GET_TGT_PARMS _IOR('S', 59, struct sioc_tgt_parms) 

#define SIOC_GET_BUS_PARMS _IOR('S', 60, struct sioc_bus_parms) 

#define SIOC_GET_LUN_LIMITS _IOR('S', 61, struct sioc_lun_limits) 

#define SIOC_GET_TGT_LIMITS _IOR('S', 62, struct sioc_tgt_limits) 

#define SIOC_GET_BUS_LIMITS _IOR('S', 63, struct sioc_bus_limits) 

#define SIOC_SET_LUN_LIMITS _IOW('S', 64, struct sioc_lun_limits) 

#define SIOC_SET_TGT_LIMITS _IOW('S', 65, struct sioc_tgt_limits) 

#define SIOC_SET_BUS_LIMITS _IOW('S', 66, struct sioc_bus_limits) 

struct sioc_lun_parms { 

unsigned int flags; 

unsigned int max_q_depth; /* maximum active I/O's */ 

unsigned int reserved[4]; /* reserved for future use */ 

in¬ 
struct sioc_lun_limits { 

unsigned int flags; 
unsigned int max_q_depth; 

unsigned int reserved[4]; /* reserved for future use */ 

in¬ 
struct sioc_tgt_parms { 

unsigned int flags; 

unsigned int width; /* bits */ 

unsigned int reqack_offset; 

unsigned int xfer_rate; /* bytes/sec */ 

unsigned int reserved[4]; /* reserved for future use */ 

in¬ 
struct sioc_tgt_limits { 

unsigned int flags; 

unsigned int max_reqack_offset; 

unsigned int max_xfer_rate; /* bytes/sec */ 

unsigned int max_width; /* bits */ 

unsigned int reserved[4]; /* reserved for future use */ 

in¬ 
struct sioc_bus_parms { 

unsigned int flags; /* reserved for future use */ 

unsigned int max_width; 
unsigned int max_reqack_offset; 

unsigned int max_xfer_rate; /* bytes/sec */ 

unsigned int reserved[4]; /* reserved for future use */ 

in¬ 
struct sioc_bus_limits { 
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unsigned int flags; 
unsigned int max width; 
unsigned int max reqack_offset; 
unsigned int max xfer_rate; 
unsigned int reserved[4); 

); 

SCSI Commands and Operations 

The SIOC IO ioctl allows an arbitrary SCSI command to be sent to a device. All details of the SCSI com¬ 
mand protocol are handled automatically. 

The foil owing flags can be used to specify the flags field value: 

SCTL_READ Data-in phase expected if the data_length field is non-zero. The 

absence of this flag implies that a data-out phase is expected if the 
data_length field is non-zero. 

SCTLINITSDTR synchronous data transfer request negotiations should be attempted 

with this command. Thisflag only appliesto parallel SCSI. 

SCTL INIT WDTR wide data transfer request negotiations should be attempted with this 

command. Thisflag only appliesto parallel SCSI. 

SCTLNODISC discpriv bit in Identify message is not set. This flag only applies to 

parallel SCSI. 

The cdb field specifies the SCSI command bytes. The number of command bytes is specified by the 
cdb_length field. These command bytes are sent to the target device during the SCSI command phase. 

The address of the data area for the data phase of the SCSI command is specified by the data field. The 
data_length field specifies the maximum number of data bytes to be transferred. A zero-valued 
data_length indicates that no data phase should occur. Most SCSI commands with a data phase expect 
the data length information to be included somewhere in the command bytes. The caller is responsible for 
correctly specifying both the data_length field and any cdb data length values. The length may not be 
larger than SCSI_MAXPHYS and some implementations further restrict this length. 

Themax_msecs field specifies the maximum time, in milliseconds, that the device should need to com¬ 
plete the command. If this period of time expires without command completion, the system might attempt 
recovery procedures to regain the device's attention. These recovery procedures might include abort tag, 
abort, and device and bus reset operations. A zero value in themax_msec field indicates that the timeout 
period is infinite and the system should wait indefinitely for command completion. 

When the SlOC_lO ioctl call returns, all command processing has been completed. Most SI0C_I0 ioctl 
calls will return zero (success). The resulting detailed ioctl data should be used to evaluate "success" or 
"failure" from the caller's perspective. The cdb_status field indicates the results of the cdb command. 
If the cdb_status field indicates a S_CHECK_CONDITION status, the sense_status field indicates 
the results of thescsi REQUEST SENSE command used to collect the associated sense data. These status 
fields will contain one of thefollowing values: 

SCTL_INVALID_REQUEST Thescsi command request is invalid and thus not attempted. 

SCTL_SELECT_TlMEOUT The target device does not answer to selection by the host SCSI interface 

(the device does not exist or does not respond). 

SCTL_lNCOMPLETE The device answered selection but the command is not completed (the dev¬ 

ice took too long or a communication failure occurred). 

S_GOOD Device successfully completed the command. 

S CHECK COND ITI ON Device indicated sense data is available. 

S CONDITION MET Device successfully completed the command and the requested (search or 

pre-fetch) operation is satisfied. 

SBUSY Device indicated it is unable to accept the command because it is busy 

doing other operations. 

S_INTERMEDIATE Device successfully completed this command, which is one in a series of 

linked commands (not supported, see warnings). 


/* reserved for future use */ 

/* bytes/sec */ 

/* reserved for future use */ 
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SICONDITION_ME T 

SRESVCONFLICT 

S_COMMAND_TERMINATED 

S_QUEUE_FULL 


Device indicated both S_INTERMEDIATE and S_C0NDITI0N_MET (not 
supported, see warnings). 

Device indicated the command conflicted with an existing reservation. 
Device indicated the command is terminated early by the host system. 

Device indicated it is unable to accept the command because its command 
queue is currently full. 


Thedata_xfer field indicates the number of data bytes actually transferred during the data phase of the 
cdb command. This field is valid only when the cdb_status field contains one of the following values: 
S_GOOD or S CHECK CONDITI ON . The sense_xfer field indicates the number of valid sense data 
bytes. This field is valid only when the cdb_status field contains the value S_CHECK_C0NDITI0N 
and the sense_status field contains the value S_GOOD. 


The SlOC_ABORT ioctl causes a SCSI ABORT message to be sent to the lun. This clears all active com¬ 
mands to theLUN from this initiator. 


The SlOC__RESET_DEV ioctl causes a SCSI device to be reset (including cl earing all active commands). On 
parallel scsi a sioc_reset_dev ioctl causes a scsi bus device reset message to be sent to the 
associated target. On Fibre Channel a SlOC_RESET_DEV ioctl causes a target reset task manage¬ 
ment function to be sent to the associated target followed by a Global Process Logout (GPRLO). 

The SIOC RESET BUS ioctl causes the system to generate a SCSI bus reset condition on the associated 
bus. A SCSI bus reset condition causes all devices on the bus to be reset (including clearing all active com¬ 
mands on all devices). The SlOC_RESET_BUS ioctl does not apply to FibreChannel. 

Often it is necessary or useful to prohibit other SCSI commands while performing device-control operations. 
Normally this should be done by gaining exclusive access via the SI0C_EXCLUSIVE ioctl. The associated 
argument points to an integer with one of these values: 

0 release exclusive access to logical unit 

1 obtain exclusive access to logical unit 

2 release exclusive access to target 

3 obtain exclusive access to target 

4 release exclusive access to bus 

5 obtain exclusive access to bus 


Occasionally exclusive access not possible (for example, diagnostic operations on a device containing a 
mounted file system). "Priority mode" causes all device-specific driver I/O operations (eg. file system I/O 
and virtual memory page swapping) and all SCSI device driver open calls (including scsi_ctl open calls) 
to the associated lun to block. These I/O operations and open calls are blocked for the entire duration that 
priority mode is in effect. While priority mode is in effect only SI0C_I0 operations should be attempted 
(these operations will not be blocked). The SI0C_PRI0RITY ioctl controls the lun priority mode. This 
ioctl is only availablevia the device-control driver. The value "1" enables priority mode. The value zero 
disables priority mode. 

The header file <sys/scsi .h > has useful information for SCSI device control. The following is included 
from <sys/scsi . h >: 

/* SCSI device control ioctls */ 

#define SIOC 10 __IOWR('S', 22, struct sctl_io) 

fdefine SIOC_RESET_DEV _IO('S', 16) 

fdefine SIOC_RESET_BUS _IO('S', 9) 

fdefine SIOC_PRIORITY_MODE _IOW('S', 67, int) 

/* Structure for SIOC_IO ioctl */ 
struct sctl io 
{ 


unsigned 


flags; 

unsigned 

char 

cdb_length; 

unsigned 

char 

cdb[16]; 

void 


*data; 

unsigned 


data_length; 

unsigned 


max_msecs; 

unsigned 


data_xfer; 

unsigned 


cdb_status ; 

unsigned 

char 

sense[256]; 
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unsigned char 

sense_xfer; 


} ; 

unsigned char 

reserved[64]; 


EXAMPLES 





Assume that tildes is a valid file descriptor for a SCSI device. The first example attempts a SCSI inquiry 
command: 

#include <sys/scsi.h> 

struct sctl_io sctl_io; 

#define MAX_LEN 255 

unsigned char inquiry_data[MAX_LEN]; 

memset(sctl_io, 0, sizeof(sctl_io)); 
sctl_io.flags = SCTLREAD; 
sctl_io.cdb[0] = 0x12; 
sctl_io.cdb[1] = 0x00; 
sctl_io.cdb[2] = 0x00; 
sctl_io.cdb[3] = 0x00; 
sctl_io.cdb[4] = MAX_LEN; 
sctl_io.cdb[5] = 0x00; 
sctl_io.cdb_length = 6; 
sctl_io.data = &inquiry_data[0]; 
sctl_io.data_length = MAX_LEN; 
sctl_io.max_msecs = 10000; 
if (ioctl(fildes, SIOC_IO, &sctl_io) 

{ 

/* request is invalid */ 

} 

The following example attempts a SCSI test unit ready command and checks to see if the device is 
ready, not ready, or in some other state. 

#include <sys/scsi.h> 
struct sctl_io sctl_io; 

memset(setl_io, 0, sizeof(sctl_io)); /* 

sctl_io.flags =0; /* 

sctl_io.cdb[0] = 0x00; /* 

sctl_io.cdb[1] = 0x00; 
sctl_io.cdb[2] = 0x00; 
sctl_io.cdb[3] = 0x00; 
sctl_io.cdb[4] = 0x00; 
sctl_io.cdb[5] = 0x00; 

sctl_io.cdb_length = 6; /* 

sctl_io.data = NULL; /* 

sctl_io.data_length =0; /* 

sctl_io.max_msecs =10000; /* 

if (ioctl(fildes, SIOC_IO, &sctl_io) < 0) 

{ 

/* request is invalid */ 

} 

else if (sctl_io.cdb_status == S_GOOD) 

{ 

/* device is ready */ 

} 

else if (sctl_io.cdb_status == S_BUSY || 

(sctl_io.cdb_status == S_CHECK_CONDITION && 
sctl_io.sense_status == S_GOOD && 
sctl_io.sense_xfer > 2 && 

(sctl_io.sense[2] & OxOF) == 2)) /* can use sense_data */ 

{ 

/* device is not ready */ 
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6 byte command */ 
no data buffer is provided */ 
do not transfer data */ 
allow 10 seconds for cmd */ 


/* clear reserved fields */ 

/* input data expected */ 

/* can use scsi.h CMDinquiry */ 


/* allocation length */ 

/* 6 byte command */ 

/* data buffer location */ 

/* maximum transfer length */ 
/* allow 10 seconds for cmd */ 
< 0) 
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) 

else 

{ 

) 


/* unknown state */ 


WARNINGS 

Incorrect use of scsi_ctl operations (even those attempting access to non-existent devices) can cause 
data loss, system panics, and device damage. 

The SIOC EXCLUSIVE ioctl should be used to gain exclusive access to a device prior to attempting 
SlOC_lO commands. If exclusive access is not obtained, SlOC_lO commands will be intermixed with 
device-specific driver commands, which can lead to undesirable results. 

Device-specific drivers can reject inappropriate or troublesome SI0C_I0 commands. However, since not 
all such operations are known and detected, care should be exercised to avoid disrupting device-specific 
drivers when using commands that modify internal device states. 

It is very easy to cause system deadlock through incorrect use of the SI0C_PRI0RITY_M0DE ioctl. Nor¬ 
mally it is necessary to lock the calling process into memory (see plock(2)) prior to enabling priority mode. 

Most SCSI commands have a logical unit number (LUN) field. Parallel SCSI implementations on the hp-ux 
operating system select logical units via the SCSI IDENTIFY message. TheLUN portion of the cdb should 
normally be set to zero, even when theLUN being accessed is not zero. 

Use of linked commands is not supported. 

Most SCSI commands with a data phase expect the data length information to be included somewhere in the 
command bytes. Both the data_length field and any cdb data length values must be correctly specified 
to get correct command results. 

Very large (or infinite) timeout values can causea parallel SCSI bus (potentially the entire system) to hang. 
Device and/or bus reset operations can be used to regain a device's attention when a timeout expires. 

Resetting a device can causei/O errors and/or loss of cached data. This can result in loss of data and/or sys¬ 
tem panics. 

Obtainingscsi inquiry data by use of the SI0C_INQUIRY ioctl instead of by use of the SlOC_lO ioctl is 
generally preferable since SCSI implementations on the hp-ux operating system synchronize access of 
inquiry data during driver open calls. 

Since communication parameters can be affected by device-specific driver capabilities, device-specific driver 
use might result in communication parameter changes. 

The SIOC CAPACITY ioctl is not supported by scsi_ctl because the meaning of capacity is device¬ 
specific. 

FILES 

/usr/include/sys/scsi . h 
/usr/include/sys/scsi_ctl.h 

SEE ALSO 

mknod(lM), ioctl(2), scsi(7). 
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NAME 

scsi_disk - SCSI direct access device driver (sdisk) 

DESCRIPTION 

This section describes the interface for access of SCSI disk, CD-ROM, and optical disk devices through the 
character special device driver. 

SCSI direct access devices store a sequence of data blocks. Each direct access device has a specific device 
size consisting of a number of data blocks and a logical block size. All data blocks have the same logical 
block size. Since I/O operations must have a size that is an integral number of blocks, one logical block size 
is the smallest possible I/O quantity. The device block size can be determined through use of the 
DIOC_DESCRIBE, DIOC_CAPACITY, and SI0C_CAPACITY ioctls (see disk(7) and scsi (7); 
SIOC CAPACITY is not supported on disc3). A direct access device that is not ready for use, whether 
due to no media installed or another reason, is interpreted to mean the device has zero size. An open () 
call to such a device succeeds, but subsequent read () and write () cal Is fail. 

The ioctl (2) manpage explains how the operations and arguments are used. Note, the arg used is com¬ 
monly the address of the parameter cited in the particular ioctl #define statement. See the EXAMPLES 
section for sample code. 

To improve performance, many SCSI disk devices have caches, which can be used for both read and write 
operations. Read cache use, called "read ahead", causes the disk drive to read data in anticipation of read 
requests. Read ahead is only apparent to users in the increased performance that it produces. Write cache 
use is called "immediate reporting". Immediate reporting increases I/O performance by reporting a com¬ 
pleted write status before the data being written is actually committed to media. If the subsequent physi¬ 
cal write operation does not complete successfully, data may be lost. Physical write failures due to media 
defects are largely eliminated by use of automatic sparing in diskdrives. Power failure between immediate 
reporting and media commit can result in cached data being lost. However, the period of time between 
these events is typically relatively small, making such losses unlikely. The SI0C_GET_IR ioctl can be 
used to determine if immediate-reporting functionality is currently being used by the device. The value 1 
indicates immediate reporting is enabled. The value zero indicates immediate reporting is disabled. The 
SI0C_SET_IR ioctl can be used to enableor disable immediate reporting. A zero valuedisablesimmedi- 
ate reporting. The value 1 enables immediate reporting. 

The SIOCSYNCCACHE ioctl can be used to force data cached in the device to media. 

Most SCSI removable media disk devices support "prevent" and "allow" media-removal commands. To 
avoid data corruption and data accessibility problems, media removal is prevented for the entire duration a 
removable media disk device is open. Because media removal is not supported, the 

SI0C_MEDIUM_CHANGED ioctl is not supported. 

The header file <sys/scsi. h> has useful information for direct access device control, including the fol¬ 
lowing: 

/* ioctl support for SCSI disk devices */ 

#define SIOC_GET_IR _IOR('S', 14, int) 

#define SIOC_SET_IR _IOW('S', 15, int) 

#define SIOC_SYNC_CACHE -IOW('S', 70, int) 

The SIOC_FORMAT ioctl reformats the entire media surface. Exclusive access to the device, obtained 
through use of the DI0C_EXCLUSIVE ioctl (see disk(7)), is required prior to reformatting to ensure that 
other applications are not affected. The fmt_optn field can be used to select the desired media geometry. 
Only one media geometry is supported on most devices. The value zero should be used for these devices. 
The value zero can also be used to select the default geometry on devices that support multiple media 
geometries. The interleave field can be used to specify sector interleaving. The valuezero specifies that an 
appropriate default interleave should be used. 

EXAMPLES 

The foil owing sample code shows how to use ioctls that affect scsi_disk. 

#include <stdio.h> 

#include <fcntl.h> 

#include <sys/errno.h> 

#include <sys/diskio.h> 

#include <sys/scsi.h> 

Describe (dfd) 
int dfd; 
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{ 

int ret; 

disk_describe_type descr_type; 

if ((ret = ioctl (dfd, DIOC_DESCRIBE, &descr_type)) != 0) { 

exit (1); 

} 

printf ("\nSuccessful ioctl DIOC_DESCRIBE \n"); 

printf (" model number: %s\n", descr_type.model_num); 

printf (" interface: %d <20=scsi>\n", descr_type.intf_type); 

} 

Exclusive (dfd) 
int dfd; 

{ 

int ret, flag=l; 

if ((ret = ioctl (dfd, DIOC_EXCLUSIVE, Sflag)) != 0) { 

exit (1); 

} 

} 

Enable_WOE (dfd) 
int dfd; 

{ 

int ret, flag=l; 

if ((ret = ioctl (dfd, SIOC_WRITE_WOE, Sflag)) != 0) { 

exit (1); 

} 

printf ("\nSuccessful ioctl SIOC_WRITE_WOE \n"); 

} 

main (argc, argv) 
int argc; 
char ** argv; 

{ int ret, fd; if (argc != 2) { 

printf ("Usage: %s <disk3_device> \n", argv[0]); 
exit (1); 

} 

if ( (fd = open (argv[l], 0_RDWR) ) < 0) { 

exit (1); 

} 

Describe (fd) ; 

Exclusive (fd) ; 

Enable_WOE (fd) ; 

} 

WARNINGS 

Historically, disk devices have had small (typically 512 byte) block sizes; however, many newer disk devices 
(such as optical disks and disk arrays) have relatively large block sizes. Applications using direct raw disk 
access should use the DI0C_DESCRIBE, DI0C_CAPACITY, or SIOC CAPACITY ioctl to determine the 
appropriate minimum I/O size. 

Media removal and insertion whilea disk device is open is unsupported and unpredictable. Do not attempt 
to circumvent prevention of media removal. Device capacity changes resulting from such intervention may 
not be recognized. 

Often larger I/O operation sizes are expected to be more efficient. However, SCSI disk I/O operations that 
are large relative to the device's cache can result in insufficient cache space for the device to maintain full- 
media-speed data transfer rates. Thiscan result in decreased I/O performance relative to smaller I/O sizes. 

DEPENDENCIES 

Optical Disk Devices 

The SIOC VERIFY WRITES ioctl controls the write mode. Normally written data is assumed to be 
correctly stored on the media. Verify-writes mode causes verification of written data to ensure that data 
has been correctly written. Verification can substantially reduce write performance and is not generally 
needed. The SI0C_VERIFY_WRITES ioctl can be used to enable or disable write verification. A zero 
value disables write verification. The value 1 enables write verification. Although write verification is 
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primarily intended for optical media, some systems may support write verification on normal disk devices. 

The SIOC VERIFY ioctl verifies that a media area contains valid data (that is, data that has been 
correctly written). Verified media will not cause I/O errors when reading is attempted. The media area to 
be verified is specified via the start_lba and block_cnt fields. Although verification is intended pri¬ 
marily for optical media, some systems may support verify operations on normal disk devices. 

The SIOCWRITEWOE ioctl controls the write mode used for magneto-optical disk devices. Normally 
magneto-optical write operations require two physical head passes. The first pass erases the media area to 
be written. The second pass actually writes the data. Write-without-erase mode dramatically increases 
write performance by skipping the first (erase media area) pass. To ensure that the correct data results, it 
is essential that write-without-erase operations be performed only on media that is known to be blank (pre¬ 
viously erased or never used). The SI0C_WRITE_W0E ioctl can be used to enable or disable write- 
without-erase. A zero valuedisables write-without-erase. Thevaluel enables write-without-erase. 


The SlOC_ERASE ioctl allows media areas to be explicitly erased. The media area to be erased is specified 
via the start_lba and block_cnt fields. Media areas erased in this manner can be written using 
write-without-erase mode. Note that an erased media area is different from a media area written with 
some data values (e.g. zeros). An erased media area should not be read. Attempting to read an erased 
media area generally results in an I/O error. 

The SI0C_VERIFY_BLANK ioctl verifies that a media area has been erased and is suitablefor being writ¬ 
ten using write-without-erase mode. The media area to be verified is specified via the startJLba and 
block_cnt fields. 


The foil owing optical disk device specific information is included from <sys/scsi .h> : 


#define SIOC WRITEWOE 
#define SIOCJVERIFY^WRITES 
#define SIOC„ERASE 
#define SIOC_ VERIFY BLANK 
#define SIOCJVERIFY 


_IOW('S' , 

17, 

int) 


IOW(' S' , 

18, 

int) 


IOW(' S' , 

19, 

struct 

scsi_erase) 

_IOW('S' , 

20, 

struct 

scsi_verify) 

_IOW('S', 

21, 

struct 

scsi_verify) 


/* structure for SIOC_ERASE ioctl */ 
struct scsi_erase { 

unsigned int start_lba; 
unsigned short block_cnt; 

} ; 


/* structure for SIOCJVERIFY^BLANK and SIOCJVERIFY ioctls */ 
struct scsi_verify { 

unsigned int start_lba; 
unsigned short block_cnt; 


FILES 

/usr/include/sys/scsi.h 

SEE ALSO 

mediainit(l), mknod(lM), ioctl(2), disk(7), scsi(7). 
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NAME 

scsipt-SCSI pass-through device driver for Series 800 NIO based systems 

DESCRIPTION 

SCSI devices are normally controlled by a device-type-specific driver when the appropriate device-type- 
specific driver exists. Device-type-specific drivers, such as those for SCSI direct access (disk) and sequen¬ 
tial access (tape) devices, coordinate device and driver states to accomplish correct logical device behavior. 
The SCSI pass-through driver (also called spt) enables use of SCSI devices and commands that are not sup¬ 
ported by these device-type-specific drivers. 

A successful scsi pt open() call requires no device I/O operations. Once open, ioctl() calls can be 
used to change SCSI communication parameters, attempt SCSI commands, or other SCSI operations. 
Since the SCSI pass-through driver does not attempt to logically understand the target device, read () 
and write() calls are not supported. Super-user privileges or device write permissions are required to 
use these ioctls. All reserved fields in the data structures associated with these ioctls must be zero- 
filled. 

Since the SCSI pass-through driver is a separate device driver, the default device-type-specific driver can¬ 
not be used for the same device at the same time as the pass-through driver. 

SCSI Commands and Operations 

Only two ioctl commands are supported by the NIO SCSI pass through driver; the SI0C_EXCLUSIVE 
command and the SI0C_I0 command. 

The SIOC EXCLUSIVE ioctl provides a mechanism to prevent other opens of a device. This allows 
exclusive access by the locking application. There are two different levels of locks supported; SCSI target 
level and SCSI lun level. These levels are specified via the data field of the ioctl() call: 

0 release exclusive access to SCSI lun 

1 gain exclusive access to SCSI lun 

2 release exclusive access to SCSI target 

3 gain exclusive access to SCSI target 

For example, to lock the device (SCSI target): 
three = 3; 

if (err = ioctl(fd, SIOC_EXCLUSIVE, Sthree)) { 

/* Could not lock the device — check err */ 

) 

NOTE: The corresponding unlock must be made for the acquired lock. An unlock of the SCSI target (data 
= 2) will NOT unlock all of the individual SCSI luns (data =0). 

The SlOC_lO ioctl allows an arbitrary SCSI command to be sent to a device. All details of the SCSI com¬ 
mand protocol are handled automatically. See EXAMPLE mentioned below. 

The header file <sys/scsi.h> has useful information for SCSI device control. The following is an 
excerpt from it: 

/* SCSI device control ioctls */ 

fdefine SIOC_IO _IOWR('S', 22, struct sctl_io) 

fdefine SIOC_EXCLUSIVE _IOW('S', 68, int) 

/* Structure for SIOC_IO ioctl */ 
struct sctl io 
{ 


unsigned 


flags; 

unsigned 

char 

cdb_length; 

unsigned 

char 

cdb[16]; 

void 


*data; 

unsigned 


data_length; 

unsigned 


max_msecs; 

unsigned 


data_xfer; 

unsigned 


cdb_status ; 

unsigned 

char 

sense[256]; 

unsigned 


sense_status 

unsigned 

char 

sense_xfer; 

unsigned 


reserved[16] 
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}; 

The flags field can have the foil owing values (if supported): 

SCTL_READ Data-in phase expected if the data_length field is non-zero. The 

absence of this flag implies that a data-out phase is expected if the 
data_length field is non-zero. 

SCTLINITSDTR synchronous data transfer request negotiations should be attempted 

with this command. 

SCTL INIT WDTR wide data transfer request negotiations should be attempted with this 

command. 

SCTL_NO_ATN device should be selected without attention (ATN). This implies that 

no SCSI message phase should be attempted with this command. (Not 
supported) 

SCTL_2BYTE device maintains 2-byte alignment. (Not supported) 

SCTL_4BYTE device maintai ns 4-byte al ignment. (Not supported) 

The cdb_length field specifies the number of valid command bytes in the cdb field. 

The cdb field specifies the SCSI command bytes. These command bytes are sent to the target device dur¬ 
ing the SCSI command phase. 

The data field specifies the address of the data area for the data phase of the SCSI command. 

The data_length field specifies the maximum number of data bytes to be transferred. A zero value in 
the data_length field indicates that no data phase should occur. Most SCSI commands with a data 
phase expect the data length information to be included somewhere in the command bytes. The caller is 
responsible for correctly specifying both the data_length field and any cdb field data length values. 
Unexpected system behavior occurs if these fields are not consistent. The data_length value may not 
be larger than 1 Megabyte. 

The max_msecs field specifies the maximum time, in milliseconds, that the device should need to com¬ 
plete the command. If this period of time expires without command completion, the system attempts 
recovery procedures to regain the device's attention. These recovery procedures may include device and 
bus reset operations. A zero value in the max_msec field indicates that the timeout period is infiniteand 
the system should wait indefinitely for command completion. Note that very large (or infinite) timeout 
values can cause the SCSI bus (potentially the entire system) to "hang". 

The data_xfer field indicates the number of data bytes actually transferred during the data phase of 
the cdb command. This field is valid only when the cdb_status field contains one of the following 
values: S_GOOD, S„CHECK_CONDITION or, S_CONDITION MET. 

The cdb_status field indicates the results of the cdb command. When the SI0C_I0 ioctl call returns, 
all command processing has been completed. Most SI0C_I0 ioctl calls will return zero (success). It is 
important, however, to always check the return value from the ioctl to ensure that an unexpected error has 
not occurred. The resulting detailed ioctl data should be used to evaluate "success" or "failure" from the 
caller's perspective. If the cdb_status field indicates a S_CHECK_C0NDITI0N status, the 
sense_status field indicates the results of the SCSI REQUEST SENSE command used to collect the 
associated sense data. These status fields will contain one of the foil owing values: 

SCTL_INVALID_REQUEST The SCSI command request is invalid and was not attempted. 

SCTL_SELECT_TIME0UT The target device did not answer to selection by the host SCSI interface 

(the device does not exist or did not respond). 

SCTL_INC0MPLETE The device answered selection but the command was not completed (the 

device took too long or a communication failure occurred, ie. device power- 
fail). 

SCTL POWERFAIL A system power recovery occurred. Error handling and retrying the com¬ 

mand may be necessary. The pass-through driver does not perform any 
powerfail recovery. 

S_GOOD Device successfully completed the command. 

S CHECKCONDITI ON Device indicated sense data was available. 
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Device successfully completed the command and the requested (search or 
pre-fetch) operation was satisfied. 

Device indicated it was unable to accept the command because it is busy 
doing other operations. 

Device indicated the command conflicted with an existing reservation. 
Device indicated the command was terminated early by the host system. 

Device indicated it was unableto accept the command because its command 
queue is currently full. 

Device successfully completed this command, which was one in a series of 
linked commands. (Not supported) 

Both S_INTERMEDIATE and S_CONDITION_MET indicated by the 
device. (Not supported) 

The sense field indicates the sense data of the SCSI REQUEST SENSE command. It is only valid if the 
sense_status field indicates successful status. 

The sense_status field indicates the results of the SCSI REQUEST SENSE command used to collect 
the associated sense data. It is only valid if the cdb_status field indicates a S_CHECK_C0NDITI0N 
status. 

The sense_xfer field indicates the number of valid sense data bytes. This field is valid only when the 
cdb_status field contains the value S_CHECK_CONDITION and the sense_status field contains 
the value S_GOOD. 

EXAMPLE 

The configuration test program provided with the SCSI pass-through driver product can be used as an 
example. It sends a SCSI INQUIRY command to the device referenced by the required special device file 
and prints out the returned inquiry data. The source for this program can be found in the file: 
/usr/contrib/src/scsi_io.c. 

WARNINGS 

• Incorrect use of SCSI device-control operations can easily cause data loss, resultingin a corrupted sys¬ 
tem. 

• Only two ioctl commands are supported; the SI0C_EXCLUSIVE command and the SlOC_lO com¬ 
mand. Any other commands attempted will return the EINVAL error. 

• It is recommended that the SI0C_EXCLUSIVE ioctl be used to gain exclusive access to a device 
prior to attempting SlOC_lO commands. This will protect against other device opens from external 
sources (for example, from another user program). If exclusive access is not obtained, SI0C_I0 
commands may be intermixed between a number of different applications which can lead to undesir¬ 
able results. 

• Most SCSI commands have a logical unit number (LUN) field. SCSI implementations on the HP-UX 
operating system select logical units via the SCSI IDENTIFY message. The LUN portion of thecdb 
should normally be set to zero, even when the LUN being accessed is not zero. 

• Most SCSI commands with a data phase expect the data length information to be included somewhere 
in the command bytes. Both the data_length field and any cdb data length values must be 
correctly specified to get correct command results. 

• Very large timeout values can cause the SCSI bus and potentially the entire system to appear to be 
"hung". 

• Unlike on the S700, the NIO SCSI pass-through driver is implemented as a stand-alone driver. To 
ensure system integrity, certain restrictions exist with its use of the bus and its interactions with 
other drivers. 

Any device accessed via the NIO SCSI pass-through driver must be on a STAND-ALONE APPLICA¬ 
TION BUS. Therefore, no boot, dump, or swap devices can be connected to this bus. While a NIO 
SCSI pass-through driver application is running, it should have exclusive use of the application bus. 
There should be no other accesses to this bus, be it from the operating system, a user, or another 
application. 


SCONDITION„ME T 
SBUSY 

SRESVCONFLICT 

S_COMMAND_TERMINATED 

S_QUEUE_FULL 

S_INTERMEDIATE 

SICONDITION_ME T 
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The controlling application can access its device(s) via the NIO SCSI pass-through driver and other 
HP standard driver(s) as long as the application handles the coordination between the various drivers. 
Thus, the application is responsible for initiating all communications to device(s) on this bus. For 
example, a tar command can not be directly used to a device on the exclusive application bus while the 
owning application is running. Any problems encountered must be displayed on this supported 
configuration (a stand-aloneapplication bus) before support can be extended. 

INSTALLATION AND CONFIGURATION 

The SCSI pass-through file set comes with the core system and will exist after an install or an update. The 
files in this set (and their proper destinations) are: 


Filename 

Protections 

Full path 

libspt.a 
scsi_io.c 
scsi_pt.7 
spt 

-r—r- 

-r—r- 

-r—r- 

-r—r- 

-r— 

-r— 

-r— 

-r— 

/usr/conf/lib/libspt.a 
/usr/contrib/src/scsi_io.c 
/usr/share/man/man7.Z/scsi_pt.7 
/usr/conf/master.d/spt 


The following configuration steps need to be completed to successfully use the NIO SCSI pass-through 
driver. This driver does not auto-configure. 

Go to the build area: 

$ cd /stand/build 
Create a system file from your existing kernel: 

$ /usr/lbin/sysadm/system_prep -s system 
Get information about peripherals attached to your system: 

$ ioscan -f 

Check if the SCSI pass-through driver is already configured into your current kernel: 

$ grep spt system 

If no "spt" line was printed, add a line to the "SCSI drivers" area of the system file: 
spt 

A driver statement is needed to override the standard driver which gets autoconfigured for any device. 
One statement is required for each desired NIO SCSI pass-through device (be it a SCSI target, or a SCSI 
lun). Append the driver line(s) to the system file: 

$ cat >> system 
driver <path> spt 

A D # control-D to exit the cat command 

where <path>is the complete hardware path of desired device (from ioscan cmd) 

Create the conf. c and config.mk files: 

$ /usr/sbin/config -s system 
Build a new kernel: 

$ make -f config.mk 

Verify that the pass-through driver has been built into the new kernel. (A line giving the revision informa¬ 
tion should be printed): 

$ what ./vmunix_test | grep scsi_pt 
Savetheold system file: 

$ mv /stand/system /stand/system.prev 
Move the new system file to be the current one: 

$ mv ./system /stand/system 
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Save the old kernel: 

$ mv /stand/vmunix /stand/vmunix.prev 
M ove the new kernel to be the current one: 

$ mv ./vmunix_test /stand/vmunix 
Boot the system from the new kernel: 

$ exec reboot 

ONCE THE SYSTEM REBOOTS: 

Verify the peripheral configuration: 

$ ioscan -f 

Determine the major number for the SCSI pass-through driver: 

$ lsdev -d spt 

Create the special device file to access the scsi_pt peripheral (refer to the example in the TROUB¬ 
LESHOOTING section): 

$ mknod /dev/ <devfilename> c <major #> <minor#> 
where 

<da/filename> name of the special device file 
<major #> character major number (from lsdev cmd) 

<minor #> minor number in theformat OxllTLOO 
where 

II 2 digit card instance number (from ioscan command; proper ext_bus 
entry) 

T Target ID number (SCSI ID) 

L Lun number (SCSI LUN) 

00 Reserved fields, must be zero 
All ready for use,try the sample program: 

Compile the sample program: 

$ cc /usr/contrib/src/scsi_io.c 
Execute the sample program: 

$ ./a. out /dev/ <da/filename> 

The sample program should have returned the inquiry data of the target device. If this did not happen, 
refer to theTROU BLESHOOTING section. 

TROUBLESHOOTING 

If the NIO SCSI pass-through driver is not working: 

• Verify the proper configuration of the SCSI pass-through driver into the kernel. 

• Verify that the hardware is set up properly. 

— Check that the device is connected, and that its SCSI Bus address is set properly. 

— Check the reference manual for the device to verify that it is configured properly. 

— Check that the SCSI Bus is properly terminated. 

— Verify that the device is operational using some other driver if possible. If a hardware problem is 
suspected, the SCSI pass-through driver must be unconfigured for that device and the HP 
specific device driver must be configured before any diagnostic software can be run. 

• Verify the special device file. 

— Execute lsdev -d spt to find the major number for the SCSI pass-through driver. For 
example, lsdev -d spt might show: 
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Character Block Driver Class 

136 -1 spt spt 

— Run ioscan -kf to find the card instance number, target SCSI ID and SCSI LUN for the 
desi red devi ce. For example ioscan -kf might show: 


Class 

I 

H/W Path 

Driver 

S/W State 

H/W Type 

Description 

be 

0 


root 

CLAIMED 

BUS_NEXUS 


ext_bus 

2 

8 

scsil 

CLAIMED 

INTERFACE 

HP 28655A - SC 

target 

0 

8.3 

target 

CLAIMED 

DEVICE 


spt 

0 

8.3.0 

spt 

CLAIMED 

DEVICE 

HP C1718T 

target 

1 

8.4 

target 

CLAIMED 

DEVICE 


spt 

1 

8.4.0 

spt 

CLAIMED 

DEVICE 

HP C1716T 

is example there are two desired devices: 



Device #1 



Device #2 


card instance number 

= 2 

card 

instance 

number = 2 

target SCSI 

ID = 3 


target SCSI ID 

= 4 

SCSI LUN = 

0 


SCSI 

LUN = 0 



— Verify that these are the same values used in the special device files. For example, 11 
/dev/c2t*d0 might show: 

crw-rw-rw- 1 root sys 136 0x023000 Dec 14 15:10 c2t3d0 
crw-rw-rw- 1 root sys 136 0x024000 Dec 14 15:10 c2t4d0 

SEE ALSO 

scsi(7), mknod(lM), uxgen(lM), reboot(2). 
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NAME 

scsi_tape - SCSI sequential access (tape) device driver 

DESCRIPTION 

SCSI sequential-access (tape) devices store a sequence of data blocks. Data can be read and written using 
either fixed or variablesized block mode. If supported by the device, variablesized block mode is normally 
used (even when all blocks are the same size). Fixed sized block mode is generally only used for tape dev¬ 
ices which do not support variable sized blocks. Fixed sized block mode can be used on some tape devices 
which support variablesized blocks to increasei/O performance. 

Generally SCSI tape devices are controlled through the mt(7) generic tape device interface. This section 
describes features that are specific to SCSI tape devices. 

The SIOC CAPACITY ioctl (see scsi (7)) can be used to determine remaining tape capacity for some tape 
devices. The blksz field indicates the "natural" block size of the device. This value may or may not be 
the current block size of the device. The number of blocks, indicated by the lba field, is an estimate of 
how much data can be written on the remaining media. A zero size is returned for devices that do not pro¬ 
vide remaining-capacity information. The quantity of data that can actually be written may be higher or 
lower than indicated, depending on such factors as block size, media defects, data compression, and ability 
to maintain streaming. 

To improve performance, most SCSI tape devices have caches. Read-cache use, called "read ahead", causes 
the tape drive to read data in anticipation of read requests. Read ahead is only apparent to users in the 
increased performance that it produces. Write-cache use is called "immediate reporting". Immediate 
reporting increases I/O performance by reporting a completed write status before the data being written is 
actually committed to media. This allows the application program to supply additional data so that con¬ 
tinuous media motion, called "streaming", can be achieved. The SlOC_GET_lR ioctl can be used to deter¬ 
mine if immediate-reporting functionality is currently being used by the device. The value "1” indicates 
immediate reporting is enabled. By default, the device driver attempts to enable immediate reporting. The 
SI0C_SET_IR ioctl can be used to explicitly enable or disableimmediate reporting. A zero value disables 
immediate reporting. The value "1" enables immediate reporting. The MTIOCTOP ioctl MTNOP com¬ 
mand can be used to cause any cached data to be written (committed) to media. Note that the device 
immediate reporting mode set by the SlOC_SET_lR ioctl survives between close () and open() 
calls, but not through system reboot. 

The SIOCGET BLOCKSIZE ioctl indicates the device's current block size. A block size of zero indi¬ 
cates the device is in variable-si zed-block mode. A non-zero block size indicates the device is in fixed-sized- 
block mode. 

The SI0C_SET_BL0CK_SIZE ioctl changes the current block size to the specified number of bytes. Set¬ 
ting the block size to zero specifies that variable-si zed-block mode should be used. Any non-zero block size 
specifies that fixed-sized-block mode should be used. By default, the device driver attempts to set the block 
size to zero during open. If variable-sized-block mode is not supported by the device, the driver selects an 
appropriate block size for fixed-sized-block mode use. Note that the device block size set by the 
SIOC_SET_BLOCK_SIZE ioctl survives between close () and open() calls, but not through system 
reboot. 

The SIOC GET BLOCK LIMITS ioctl indicates the device's maximum and minimum fixed block-size 
limits. The device's minimum fixed block size is indicated by the min_blk_size field. The 
max_blk_size field contains the smaller of the maximum block size supported by the device and the 
maximum block size supported by the system (MAXPHYS). This is the largest valid block size for the 
specific combination of device, driver, and host system being used. 

The SIOC GET POSITION ioctl can be used to determine the current media position for some devices. 
For devices that support this capability, the resultant value can be used to reposition the media to the same 
position in the future. 

The SI0C_SET_P0SITI0N ioctl can be used to cause media repositioning on some devices. For devices 
that support this capability, media repositioning via this mechanism can generally be completed more 
quickly than might be similarly accomplished using record, filemark, or setmark spacing. The argument 
value specified should be the result of a previous SI0C_GET_P0SITI0N for that media volume. 

The foil owing is included from <sys/scsi .h >: 

/* ioctl support for SCSI tape commands */ 
fdefine SIOC_GET_IR _IOR('S', 14, int) 

#define SIOC_SET_IR _IOW('S', 15, int) 
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#define SIOC„GET_BLOCK_SIZE _IOR('S', 30, int) 

fdefine SIOC_SET_BLOCK_SIZE _IOW('S', 31, int) 

fdefine SIOC GET BLOCK LIMITS _IOW('S', 32, struct scsi block limits) 

fdefine SIOC_GET_POSITION _IOR('S', 33, int) 

fdefine SIOC_SET_POSITION _IOW('S', 34, int) 

/* structure for SI0C_GET BLOCK LIMITS ioctl */ 
struct scsi block limits { 

unsigned min blk_size; 
unsigned max blk^size; 

} ; 

WARNINGS 

SCSI bus and device resets cause some devices to reposition media to beginning-of-tape (BOT). Thisuninten- 
tional media repositioning can cause loss of data. The scsi_tape driver causes the first subsequent 
open () attempt to fail as an indication of potential data loss. 

The scsi_tape driver does not write filemarks at close if the media has been programatically reposi¬ 
tioned. Applications that reposition the media prior to closing the device should write any required tape- 
marks. 

SEE ALSO 

scsi (7), mt(7), mknod(lM). 
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NAME 

socket - interprocess communications 

DESCRIPTION 

Sockets are communication endpoints that allow processes to communicate either locally or remotely. They 
are accessed by means of a set of system calls (see socket(2)). 

Thefollowing ioctl() requests are defined in <sys/ioctl.h>(seeioctl(2)): 

FIOSNBIO If the int with the address arg is non-zero, the socket is put into non-blocking mode. Other¬ 
wise, the socket is put into blocking mode. Blocking mode is the default. The FIONBIO 
request is equivalent to the FIOSNBIO request, although using FIONBIO is not recom¬ 
mended. See accept(2), connect(2), recv(2), and send(2) for an explanation of how non- 
blocking mode is used. 

FIONREAD For SOCK STREAM sockets, the number of bytes currently readable from this socket is 
returned in the integer with the address arg. For SOCK DGRAM sockets, the number of 
bytes currently readable, plus the size of the sockaddr structure (defined in 
<sys/socket. h >), is returned in the integer with the address arg. 

SIOCATMARK For SOCK STREAM TCP sockets, on return the integer with the address arg is non-zero if 
the inbound TCP stream has been read up to where the out-of-band data byte starts. Other¬ 
wise, the inbound TCP stream has not yet been read up to where the out-of-band data byte 
starts. For sockets other than SOCK STREAM TCP sockets, on return the integer with the 
address arg is always zero. 

SIOCSPGRP This request sets the process group or process id associated with the socket to be the value 
of the integer with the address arg. A process group or process id associated with the 
socket in this manner is signaled when the state of the socket changes: SIGURG is 
delivered upon the receipt of out-of-band data; SIGIO is delivered if the socket is asyn¬ 
chronous, as described in FIOASYNC below. If the value of the integer with the address 
arg is positive, the signal is sent to the process whose process id matches the value 
specified. If the value is negative, the signal is sent to all the processes that have a process 
group equal to the absolute value of the value specified. If the value is zero, no signal is 
sent to any process. It is necesary to issue this request with a non-zero integer value to 
enable the signal delivery mechanism described above. The default for the process group or 
process id value is zero. 

SIOCGPGRP This request returns the process group or process id associated with the socket in the 
integer with the address arg. See the explanation for SIOCSPGRP above for more details 
on the meaning of the integer value returned. 

FIOASYNC If the integer whose address is arg is non-zero, this request sets the state of the socket as 
asynchronous. Otherwise, the socket is put into synchronous mode (the default). Asyn¬ 
chronous mode enables the delivery of the SIGIO signal when: 

• New data arrives, or 

• For connection-oriented protocols, whenever additional outgoing buffer space 
becomes availableor when theconnection is established or broken. 

The process group or process id associated with the socket must be non-zero in order for 
SIGIO signals to be sent. The signal is delivered according to the semantics of 
SIOCSPGRP described above. 

Thefcntl(2) 0_NDELAY and 0_N0NBL0CK flags (defined in <fcntl.h>) are supported by sockets. If 
the O NONBLOCK flag is set, the socket is put into POSix-style non-blocking mode. If the 0_NDELAY 
flag is set, the socket is put into non-blocking mode. Otherwise, the socket is put into blocking mode. 
Blocking mode is the default. See accept(2), connect(2), recv(2), and send(2) for an explanation of how these 
forms of non-blocking mode are used. 

Since the fcntl () 0_NONBLOCK and 0_NDELAY flags and ioctl() FIOSNBIO requests are sup¬ 
ported, the following clarifies on how these features interact. If the 0_N0NBL0CK or 0_NDELAY flag 
has been set, recv() and send() requests behave accordingly, regardless of any FIOSNBIO requests. 
If neither the 0_N0NBL0CK flag nor the 0_NDELAY flag has been set, FIOSNBIO requests control the 
the behavior of recv() and send (). 
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DEPENDENCIES 
AF_CCITT Only 

Only the FIOSNBIO, FIONREAD, SIOCGPGRP, and SIOCSPGRP ioctl () requests are defined for 
af_ccitt sockets. See socketx25(7). 

AUTHOR 

socket was developed by the University of California, Berkeley. 

SEE ALSO 

fcntl(2), getsockopt(2), ioctl(2), socket(2), socketx25(7). 
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NAME 

streamio- STREAMS ioctl commands 


SYNOPSIS 

#include <sys/types.h> 

#include <stropts.h> 

int ioctl (int fildes, int command, ... /* arg */) ; 


DESCRIPTION 

STREAMS ioctl commands are a subset of the ioctl () system calls which perform a variety of control 
functions on streams. 

fildes is an open file descriptor that refers to a stream, command determines the control function to be per¬ 
formed as described below, arg represents additional information that is needed by this command. The 
type of arg depends upon the command, but it is generally an integer or a pointer to a command-specific 
data structure. The command and arg are interpreted by the stream head. Certain combinations of these 
arguments may be passed to a module or driver in the stream. 

Since these STREAMS commands are a subset of ioctl, they are subject to the errors described there. In 
addition to those errors, the call will fail with errno set to El NVAL, without processing a control function, 
if the stream referenced by fildes is linked below a multiplexor, or if command is not a valid value for a 
stream. 

Also, as described in ioctl, STREAMS modules and drivers can detect errors. I n this case, the module or 
driver sends an error message to the stream head containing an error value. This causes subsequent sys¬ 
tem calls to fail with errno set to this value. 


The following ioctl commands, with error values indicated, areapplicableto all STREAMS files: 

I_ATMARK Allows the user to see if the current message on the stream head read queue is 
"marked" by some module downstream, arg determines how the checking is done 
when there are multiple marked messages on the stream head read queue. It may 
take the foil owing values: 

ANYMARK Checks if the message is marked. 

LASTMARK Checks if the message is the last one that is marked on the queue. 

If both ANYMARK and LASTMARK are set, ANYMARK supersedes LASTMARK. 

The return value is 1 if the mark condition is satisfied and 0 otherwise. 

I CANPUT Checks if a certain band is writable, arg is set to the priority band in question. The 
return value is 0 if the priority band arg is flow controlled, 1 if the band is writable, or 
-1 on error. 


I_CKBAND Check if the message of a given priority band exists on the stream head read queue. 

This returns 1 if a message of a given priority exists, or -1 on error, arg should bean 
integer containingthe valueof the priority band in question. 

I_FDINSERT Creates a message from user specified buffer(s), adds information about another 
stream and sends the message downstream. The message contains a control part and 
an optional data part. The data and control parts to be sent are distinguished by 
placement in separate buffers, as described below. 


arg points to a strfdinsert structure which contains thefollowing members: 


struct strbuf 

struct strbuf 

long 

int 

int 


ctlbuf; 
databuf; 
options; 
fildes; 
offset; 


The len field in the ctlbuf strbuf structure (see putmsg(2)) must be set to the 
size of a pointer plus the number of bytes of control information to be sent with the 
message, fildes in the strfdinsert structure specifies the file descriptor of the 
other stream, offset, which must be word-aligned, specifies the number of bytes 
beyond the beginning of the control buffer where I_FDINSERT will store a pointer. 
This pointer will be the address of the read queue structure of the driver for the 
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streams corresponding to tildes in the strfdinsert structure. The len field in the 
databuf strbuf structure must be set to the number of bytes of data information 
to be sent with the message or zero if no data part is to be sent. 

flags specifies the type of message to be created. An ordinary (non-priority) message 
is created if flags is set to 0, a high priority message is created if flags is set to 
RS_HIPRI. For normal messages, I_FDINSERT will block if the stream write 
queue is full due to internal flow control conditions. For high priority messages, 
I_FDINSERT does not block on this condition. For normal messages, I_FDINSERT 
does not block when the write queue is full and the 0_NONBLOCK is set. Instead, it 
fails and sets errno to E AGAIN. 

I_FDINSERT also blocks, unless prevented by the lack of internal resources, waiting 
for the availability of message blocks, regardless of priority or whether 0_N0NBL0CK 
has been specified. No partial message is sent. 

I_FDINSERT can also fail if an error message was received by the stream head of 
the stream corresponding to fildes in the strfdinsert structure. In this case, 
errno will be set to the value in the message. 

I_FIND Compares the names of all modules currently present on the stream to the name 
specified in arg. The command returns a value of 1 if the module is present and a 
value of 0 (zero) if the module is not present. 

I_FLUSH This request flushes all input and/or output queues, depending on the value of arg. 
Valid arg values are: 

FLUSHRW Flush write and read queues. 

FLUSHW Flush write queues. 

FLUSHR Flush read queues. 

If a pipe or FIFO does not have any modules pushed, the read queue of the streams 

head on either end isflushed depending on thevalueof arg. 

If FLUSHR is set and fildes is a pipe, the read queue for that end of the pipe is flushed 
and the write queue for the other end is flushed. If fildes is a FIFO, both queues are 
flushed. 

If FLUSHW is set and fildes is a pipe and the other end of the pipe exists, the read 
queue for the other end of the pipe is flushed and the write queue for this end is 
flushed. If fildes is a FI FO, both queues of the FIFO are flushed. 

If FLUSHRW is set, all read queues are flushed, that is the read queue for the FIFO 
and the read queue of boths ends of the pipe are flushed. 

Correct flushing handling of a pipe or FIFO with modules pushed is achieved via the 
pipemod module. This module should be the first module pushed onto a pipe so that 
it is at the midpoint of the pipe itself. 

I_FLUSHBAND 

Flushes a particular band of messages, arg points to a bandinfo structure that has 
th e fol I owi n g members: 

unsigned char bi_pri: 

int bi_option; 

Thevalueof the bioption field can be FLUSHR, FLUSHW, or FLUSHRW as described 
for the I_FLUSH command. 

I_GETBAND Returns the priority band of the first message on the stream head read queue in the 
integer referenced by arg. 

I_GETCLTIME 

Returns the close time delay in the long pointed by arg. 

I_SETCLTIME 

Allows the user to set the time that the stream head will delay when a stream is clos¬ 
ing, and there is data on the write queues. Before closing each module and driver, the 
stream head will delay for the specified amount of time to allow the data to drain. If, 
after the delay, data is still present, data will be flushed, arg is a pointer to the 
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I_GETSIG 

I_GRDOPT 

I_GWROPT 

ILINK 


I_LIST 


ILOOK 


I__NREAD 


I_PEEK 


number of milliseconds to delay, rounded up to the nearest valid value on the system. 
The default is fifteen seconds. 

Returns the events for which the calling process has registered to receive a SIG- 
POLL signal. Events are returned as in arg bitmask as defined for the I_SETSIG 
command. 

Returns the current read mode setting in an int pointed to by the argument arg. 
Read modes are described in read(2). 

Returns the current write mode setting, as described in l_SWROPT, in the int that is 
pointed to by the argument arg. 

Connects two streams, where tildes is the file descriptor of the stream connected to 
the multiplexing driver, and arg is the file descriptor of the stream connected to 
another driver. The stream designated by arg gets connected below the multiplexing 
driver. I_LINK requires the multiplexing driver to send an acknowledgement mes¬ 
sage to the stream head regarding the linking operation. This call returns a multi¬ 
plexor ID number (an identifier used to disconnect the multiplexor, see I_UNLINK) 
on success, and -1 on failure. 

Allows the user to list all the module names on the stream, up to and including the 
topmost driver name. If arg is NULL, the return value is the number of modules, 
including the driver, that are on the stream pointed to by fildes. This allows the user 
to allocate enough space for the module names. If arg is not NULL, it should point to a 
str_list structure that has thefollowing members: 

int sl_nmods ; 

struct str_mlist *sl_modlist; 

The str_mlist structure has thefollowing member: 

char l_name[FMNAMESZ+1]; 

sl_nmods indicates the number of entries the user has allocated in the array. On 
success, the return value is 0, sl_modlist contains the list of module names, and 
sl_nmods indicates the number of entries that have been filled in. 

Retrieves the name of the module located just below the streams head of the stream 
pointed to by fildes, and places it in a null terminated character string pointed at by 
arg. The buffer pointed to by arg should be at least FNAMESZ+1 bytes long. A 
#include <stropts.h> declaration is required. 

Counts the number of data bytes in data blocks in the first message on the stream 
head read queue, and places this value in the location pointed to by arg. The return 
value for the command is the number of messages on the stream head read queue. 
For example, if zero is returned in arg, but the ioctl return value is greater than 
zero, this indicates that a zero-length message is next on the queue. 

Allows the user process to look (peek) at the contents of the first message on the 
stream head read queue. This is done without taking the message off the queue. The 
I_PEEK ioctl operates the same way as the getmsgO function, except that it 
does not remove the message. The arg parameter points to a strpeek structure (in 
the <stropts.h> header file) with thefollowing members: 

struct strbuf ctlbuf; 

struct strbuf databuf; 

long options; 

The strbuf structure pointed to by ctlbuf and databuf has the following 
members: 

int maxlen; 
int len; 
char *buf 

The maxlen field of the strbuf structure must specify the number of bytes of con¬ 
trol or data information to be retrieved. The options field can beset to RS_HIPRI or 
0 (zero). If this field is set to RS_HIPRI, the I_PEEK ioctl looks for a high 
priority message on the queue. If the field is set to 0, the I_PEEK ioctl looks at 
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I_PLINK 


I_POP 

I_PUNLINK 

I_PUSH 

I„RECVFD 


I_SENDFD 


the first message on the queue. 

The I_PEEK returns a 1 if a message was retrieved, and returns a value of 0 (zero) if 
no message was found; it does not wait for a message. Upon successful completion, 
ctlbuf specifies control information in the control buffer, databuf specifies data 
information in the data buffer, and options contains RS_HIPRI or 0 (zero). 

Connects two streams, where fildes is the file descriptor of the stream connected to 
the multiplexing driver, and arg is the file descriptor of the stream connected to 
another driver. The stream designated by arg gets connected via a persistent link 
below the multiplexing driver. I_PLINK requires the multiplexing driver to send an 
acknowledgement message to the stream head regarding the linking operation. This 
call creates a persistent link which can exist even if the file descriptor associated with 
the upper stream to the multiplexing driver is closed. This call returns a multiplexor 
ID number (an identifier that may be used to disconnect the multiplexor, see 
I_PUNLINK) on success and -1 on failure. 

The I_PLINK ioctl can also fail if it is waiting for the multiplexing driver to ack¬ 
nowledge the link request and an error (M_ERROR) message, or hangup (M_HANGUP) 
message is received at the stream head for fildes. In addition, an error can be 
returned in an M_lOACK or M_I0NAK message. When these occur, the I_PLINK 
failswith errno set to the value in the message. 

Removes the module just below the stream head of the stream pointed to by fildes. To 
remove a module from a pipe requires that the module was pushed on the side it is 
being removed from, arg should be0 in an l_POP request. 

Disconnects the two streams specified by fildes and arg that are connected with a per¬ 
sistent link, fildes is the file descriptor of the stream connected to the multiplexing 
driver, arg is the multiplexor ID number that was returned by I_PLINK when a 
stream was linked below the multiplexing driver. If arg is MUXID_ALL, then all 
streams which are persistent links to fildes are disconnected. As in I_PLINK, this 
command requires the multiplexing driver to acknowledge the unlink. 

Pushes the module whose name is pointed by arg onto the top of the current stream, 
just below the stream head. If the stream is a pipe, the module will be inserted 
between the streams heads of both ends of the pipe. It then calls the open routine of 
the newly-pushed module. 

Retrieves the file descriptor associated with the message sent by an I_SENDFD 
ioctl over a stream pipe, arg is a pointer to a data buffer large enough to hold a 
strrecvfd data structure containingthefollowing members: 

int fd; 

uid_t uid; 

gid_t gid; 

char fill[8] 

fd is an integer file descriptor, uid and gid are the user ID and group ID, respec¬ 
tively, of the sending stream. 

If 0_N0NBL0CK is dear, I_RECVFD will block until a message is present at the 
stream head. If 0__NONBLOCK is set, I_RECVFD will fail with errno set to 
E AGAIN if no message is present at the stream head. 

I f the message at the stream head is a message sent by a I_SENDFD , a new user file 
descriptor is allocated for the file pointer contained in the message. The new file 
descriptor is placed in the fd field of the strrecvfd structure. The structure is 
copied into the user data buffer pointed to by arg. 

Requests the stream associated with fildes to send a message, containing a file 
pointer, to the stream head at the other end of a stream pipe. The file pointer 
corresponds to arg, which must bean open file descriptor. 

I_SENDFD converts arg into the corresponding system file pointer. It allocates a 
message block and inserts the file pointer in the block. The user ID and group ID 
associated with the sending process are also inserted. This message is placed directly 
on the read queue of the stream head at the other end of the stream pipe to which it is 
connected. 
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I_SETCLTIME 

Lets the user process set the time that the stream head delays when the stream is 
closing and the write queues contain data. The arg parameter contains a pointer to 
the number of milliseconds to delay, rounded up to the nearest legal valueon the sys¬ 
tem. The default time is 15 seconds. 

Before STREAMS modules and drivers are closed, the stream head delays for the 
specified amount of time. This allows the data on the write queues to drain. If data is 
still present on the writes queues after the delay, the queues are flushed. 

I_SETSIG I nforms the stream head that the user wants the kernel to issue the SIGPOLL signal 
(see signal (2)) when a particular event has occurred on the stream associated with 
fildes. I_SETSIG supports an asynchronous processing capability in STREAMS. 
The value of arg is a bitmask that specifies the events for which the user should be 
signaled. It is the bitwise-OR of any combination, except where noted, of thefollowing 
constants: 

S„BANDURG When used in conjunction with S_RDBAND, SIGURG is gen¬ 
erated instead of SIGPOLL when a priority message reaches the 
front of the stream head read queue. 

S_ERROR An M_ERROR message has reached the stream head. 

S HANGUP An M_HANGUP message has reached the stream head. 

S_HIPRI A high priority message is present on the stream head read 

queue. This is set even if the message is of zero length. 

S_INPUT Any message other than an M_PCPROTO has arrived on a 
stream head read queue. This event is maintained for compati¬ 
bility with prior releases. This is set even if the message is of 
zero length. 

S_MSG A STREAMS signal message that contains the SIGPOLL signal 

has reached the front of the stream head read queue. 

S OUTPUT The write queue just below the stream head is no longer full. 

This notifies the user that there is room on the queue for sending 
(or writing) data downstream. 

S_RDBAND A priority band message (band >0) has arrived on a stream head 
read queue. This is set even if the message is of zero-length. 

S_RDNORM An ordinary (non-priority) message has arrived on a stream head 
read queue. This is set even if the message is of zero-length. 

S_WRBAND A priority band greater than 0 of a queue downstream exists and 
is writable. This notifies the user that there is room on the queue 
for sending (or writing) priority data downstream. 

S WRNORM This event is the same as S_OUTPUT. 

A user process may choose to be signaled only of high priority messages by setting arg 
bitmask to the value S_HIPRI. 

Processes that want to receive SIGPOLL signals must explicitly register to receive 
them using I_SETSIG. If several processes register to receive the signal for the 
same event on the same stream, each process will be signaled when the event occurs. 

If the value of arg is zero, the calling process will be unregistered and will not receive 
further SIGPOLL signals. 

l_SRDOPT Sets the read mode (see read(2)) using the value of the argument arg. Valid arg 
values are: 

RNORM Byte-stream mode (default). 

RMSGD Message-discard mode. 

RMSGN Message-nondiscard mode. 

Setting both RMSGD and RMSGN is an error. RMSGD and RMSGN override NORM. 
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I n addition, treatment of control messages by the stream head may be changed by set¬ 
ting thefollowingflagsin arg: 

RPROTNORM Fail read with EBADMSG if a control message is at the front of 
the stream head read queue. This is the default behavior. 

RPROTDAT Deliver the control portion of a message as data when a user 
issues read. 

RPROTDIS Discard the control portion of a message, delivering any data 
portion, when a user issues a read. 

I_STR Constructs an internal STREAMS ioctl message from the data pointed to by arg, 

and sends that message downstream. 

This mechanism is provided to send user ioctl requests to downstream modules 
and drivers. It allows information to be sent with the ioctl, and will return to the 
user any information sent upstream by the downstream recipient. I_STR blocks until 
the system responds with either a positive or negative acknowledgement message, or 
until the request "times out" after some period of time. If the request times out, it 
fails with errno set to ETI ME. 

At most, one I_STR can be active on a stream. Further I_STR calls will block until 
the active I_STR completes at the stream head. The default timeout intervals for 
these requests is 15 seconds. The 0_N0NBL0CK (see open (2)) flags have no effect on 
this call. 

To send requests downstream, arg must point to a strioctl structure which con¬ 
tains thefollowing members: 

int ic_cmd; 

int ic_timeout; 

int ic_len; 

char *ic_dp; 

ic_cmd is the internal ioctl command intended for the downstream module or 
driver and ic_timeout is the number of seconds (-1 infinite, 0 = use default, >0 = 
as specified) an I_STR request will wait for acknowledgement before timing out. The 
default timeout is infinite. ic_len is the number of bytes in the data argument and 
ic_dp is a pointer to the data argument. The ic_len field has two uses: on input, 
it contains the length of the data argument passed in, and on return from the com¬ 
mand, it contains the number of bytes being returned to the user (the buffer pointed 
to by ic_dp should be large enough to contain the maximum amount of data that 
any module or driver in the stream can return). The stream head will convert the 
information pointed to by strioctl structure to an internal ioctl command mes¬ 
sage and send it downstream. 

I_SWR0PT Sets the write mode using the value of the argument arg. Legal bit settings for arg 
are: 

SNDZERO Sends a zero-length message downstream when a write of 0 
bytes occurs. To not send a zero-length message when a write of 
0 bytes occurs, this bit must not beset in arg. 

I_UNLINK Disconnects the two streams specified by fildes and arg. fildes is the file descriptor of 
the stream connected to the multiplexing driver, arg is the multiplexor ID number 
that was returned by the I_LINK. If arg is MUXID_ALL , then all streams which 
were linked to fildes are disconnected. As in I_LINK, this command requires the 
multiplexing driver to acknowledge the unlink. 

RETURN VALUE 

Unless specified differently for a command, the return valuefor a STREAMS ioctl () call is 0 (zero) on 
success and -1 (minus one) on failure. 
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ERRORS 

A STREAMS ioctl command fails without performing thefunction and with errno set to [EINVAL] if: 

• The stream referred to by fildes is linked below a multiplexing driver. 

• The command parameter is not a valid valuefor the stream. 

In addition, if any of the following conditions occur, the STREAMS ioctl commands return the 

corresponding value: 

I_ATMARK 

[EINVAL] arg has an illegal value. 

I_CANPUT 

[EINVAL] arg has an illegal value. 

I_CKBAND 

[EINVAL] arg has an illegal value. 

I_FDINSERT 

[El NVAL] The fildes parameter in the strfdinsert structure is an invalid open file descrip¬ 
tor. 

[EINVAL] The size of the pointer plus offset exceeds the value of the len field for the buffer 
specified through ctlptr. 

[El NVAL] offset does not specify a properly aligned location in thedata buffer. 

[EINVAL] options contains an undefined value. 

[EFAULT] arg points, or ctrlbuf or databuf is outsidetheallocated address space. 

[EAGAIN] The ioctl request failed because a non-priority message was to be created, the 

0_N0NBL0CK option was set, and the stream's write queue was full because of inter¬ 
nal flow control conditions. 

[ENOSR] Buffers could not be allocated for the message that was to be created due to 
insufficient STREAMS memory resources. 

[ENXIO] A hangup was received on the stream specified by fildes in the I_FDINSERT ioctl 
call or on the stream specified by fildes in the strfdinsert. 

[ERANGE] The value of the len field for the buffer specified through databuf does not fall 
within the range for the minimum and maximum sizes of packets for the top-most 
module on the stream. 

[ERANGE] The value of the len field for the buffer specified through databuf is larger than the 
maximum allowable size for thedata part of a message. 

[ERANGE] The value of the len field for the buffer specified through ctlbuf is larger than the 
maximum allowable size for the control part of a message. 

The I_FDINSERT ioctl can also fail if an error (M_j2RROR ) message was received 
by the stream specified by the fildes field in the strfdinsert structure. In this 
case, errno is set to the error value in the error message. 

I_FIND 

[El NVAL] arg does not contain a valid module name. 

[EFAULT] arg points outside the allocated address space. 

I_FLUSH 

[ENOSR] Could not allocate buffers for flush operation because of a lack of STREAMS memory 
resources. 

[EINVAL] The arg parameter isan invalid value. 

[ENXIO] A hangup was received on fildes. 

I_FLUSHBAND 
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[EINVAL] The bi_pr parameter value exceeds the maximum band, or the bi_option parameter is 

not FLUSHR, FLUSHW, or FLUSHRW. 

I_GETBAND 

[ENODATA] No message exists on the stream head read queue. 

IGETSIG 

[EINVAL] User process is not registered to receive the SIGPOLL signal. 

[E FAULT] arg points outside the allocated address space. 

IGRDOPT 

[E FAULT] arg is pointing outside the allocated address space. 

I_LINK 

[EAGAIN] Temporarily unable to allocate storage to perform the linking operation. 

[EBADF] The arg parameter not a valid open file descriptor. 

[ENXIO] A hangup was received on fildes. 

[El NVAL] The stream referred to by fildes does not support multiplexing. 

[EINVAL] The file referred to by arg is not a stream, or the stream is already linked under a 

multiplexor. 

[EINVAL] The link operation would cause a "cycle' 1 in the resulting multiplexing configuration. 

In other words, the driver referred to by the arg parameter is linked into this 
configuration at multiple places 

[ENOSR] Not enough STREAMS memory resources to allocate storage for this command. 

[ETI ME] Acknowledgement message not received at stream head before timeout. 

The I_LINK ioctl can also fail if an M_ERROR or M_HANGUP message is received at the 
stream head for fildes before receiving the driver acknowledgement. I n addition, an error can be 
returned in an M_I0CACK or M_lOCNAK message. When these occur, the I_LINK ioctl 
fails with errno set to the value in the message. 

ILIST 

[EINVAL] sl_nmods is less than 1. 

[EAGAIN] Could not allocate buffers. 

I_LOOK 

[El NVAL] There are no modules in the stream. 

[E FAULT] arg points outside the allocated address space. 

I^NREAD 

[E FAULT] arg is pointing outside the allocated address space. 

I_PEEK 

[El NVAL] The options parameter is an illegal value. 

[EFAULT] arg points, or ctrlbuf or databuf is, outsidetheallocated address space. 

[EBADMSG] Message to be looked at is not valid for the I_PEEK command. 

I_PLINK 

[ENXIO] A hangup was received on the stream referred to by the fildes parameter. 

[ETIME] A timeout occurred before an acknowledgement message was received at the stream 
head. 

[EAGAI N] Temporarily unable to allocate storage to perform the linking operation. 

[EBADF] arg is not a valid open file descriptor. 

[El NVAL] The stream referred to by fildes does not support multiplexing. 
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[EINVAL] The file referred to by arg is not a stream or is already linked under a multiplexing 
driver. 

[EINVAL] The link operation would cause a "cycle' 1 in the resulting multiplexing configuration. 

In other words, the driver referred to by arg is linked into the configuration at multi¬ 
ple places. 

I_POP 

[El NVAL] There are not modules in the stream. 

[ENXIO] Error value returned by the module being popped. 

[ENXIO] A hangup was received on fildes. 

I_PUNLINK 

[ENXIO] A hangup was received on fildes. 

[ETIME] A timeout occurred before an acknowledgement message was received at the stream 
head. 

[EAGAIN] Temporarily unable to allocate storage to perform the linking operation. 

[El NVAL] arg is an invalid multiplexor ID number. 

[El NVAL] fildes is the file descriptor of a pipe. 

An I_PUNLINK ioctl can also fail if it is waiting for the multiplexor to acknowledge the 
unlink request and an error (M_ERROR) message, or hangup (M_HANGUP) is received at the 
stream head for fildes. In addition, an error can be returned in an M_I0CACK or M„I0CNAK 
message. When these occur, the P_UNLINK ioctl fails with errno set to the value in the 
message. 

I_PUSH 

[El NVAL] An invalid module name was used. 

[E FAULT] arg points outside the allocated address space. 

[ENXIO] Error value returned by the module being pushed. Thepush hasfailed. 

[ENXIO] A hangup was received on fildes. 

IRECVFD 

[EAGAI N] The 0_N0NBL0CK option was set, and a message was not present on the stream head 
read queue. 

[E FAULT] The arg parameter points outside the allocated address space. 

[EBADMSG] The message present on the stream head read queue did not contain a passed file 
descriptor. 

[EMFILE] Too many open files. No more file descriptors are permitted to be opened. 

[ENXIO] A hangup was received on fildes. 

I_SENDFD 

[EAGAI N] The sending stream head could not allocate a message block for the file pointer. 

[EAGAI N] The read queue of the receiving stream head was full and could not accept the mes¬ 

sage. 

[EBADF] The arg parameter is not a valid open file descriptor. 

[El NVAL] The fildes parameter does not refer to a stream. 

[ENXIO] A hangup was received on fildes. 

I_SETCLTIME 

[EINVAL] arg has an illegal value. 

ISETSIG 

[El NVAL] The user process is not registered to receive the SIGPOLL signal. 
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[EAGAIN] A data structure to store the signal request could not be allocated. 

ISRDOPT 

[El NVAL] arg contains an illegal value. 

I_STR 

[El NVAL] The ic_len field is less than 0 (zero) bytes or larger than the maximum allowable 
size of the data part of a message (ic_dp). 

[El NVAL] The ic_timeout field is less than-1. 

[EFAULT] arg points, or the buffer area specified by ic_dp or ic_len is, outside the allocated 
address space. 

[ENOSR] Buffers could not be allocated for the ioctl request because of a lack of STREAMS 
memory resources. 

[ENXIO] A hangup was received on the stream referred to by tildes. 

[ETIME] The ioctl request timed out before an acknowledgement was received. 

The I_STR ioctl can also fail if the stream head receives a message indicating an error 
(M_ERROR) or a hangup (M_HANGUP). In addition, an error can be returned in an M_I0CACK 
or MIOCNAK message. In these cases, the ioctl fails with errno set to the error value in 
the message. 

ISWROPT 

[El NVAL] The arg parameter is an illegal value. 

I_UNLINK 

[ENXIO] A hangup was received on tildes. 

[ETIME] A timeout occurred before an acknowledgement message was received at the stream 
head. 

[El NVAL] arg is an invalid multiplexor ID number, or tildes is already linked under a multiplex¬ 
ing driver. 

An I_UNLINK ioctl can also fail if it is waiting for the multiplexor to acknowledge the unlink 
request and an error (M_ERROR) message, or hangup (M_HANGUP) is received at the stream 
head for tildes. In addition, an error can be returned in M_lOCACK or M_I0CNAK message. 
When this occurs, the I_UNLINK ioctl fails with errno set to the value in the message. 

SEE ALSO 

dose(2), fcntl(2), getmsg(2), ioctl(2), open(2), polI(2), putmsg(2), read(2), write(2), signal(5). 
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NAME 

strlog - STREAMS log driver 

DESCRIPTION 

The STREAMS log driver allows user-level processes and STREAMS drivers and modules to perform error 
logging and event tracing. These tasks are done via a user interface and a kernel interface. Further, the 
STREAMS log driver delivers error logging and event tracing messages to the Network Tracing and Log¬ 
ging Facility (NetTL) (seenettl (1M), netfmt(lM), and nettlconf(lM)). 

The interface that this driver presents to user-level processes is a subset of the ioctl () system calls and 
STREAMS message formats. These processes can be error loggers, trace loggers, or other user processes, 
that generate error or event messages. The user interface collects log messages from the log driver, and 
also generates log messages from user processes. 

The driver also accepts log messages from STREAMS drivers and modules in the kernel via its function call 
interface. The kernel interface enters requests or calls from STREAMS drivers and modules into log mes¬ 
sages. 

The log messages accepted by the log driver are also delivered to NetTL. NetTL can be used to control 
which types of messages to log, and to format and filter the logged messages. 

Kernel Interface 

STREAMS drivers and modules generate log messages by callsto the strlog function. 

#include <sys/strlog.h> 

int strlog (mid, sid, level, flags, fmt [, value ]...); 

short mid; 

short sid; 

char level; 

ushort flags; 

char * fmt; 

int value; 

mid specifies the STREAMS modulelD number for the driver or module submitting the log message. 

sid specifies the sub-1 D number of a minor device associated with the STREAMS module or driver 

identified by mid. 

la/el specifies a level for screening lower-level event messages from a tracer, 
flags contains several flags that can beset in various combinations. The flags are as follows: 
SL_ERROR The message is for the error logger. 

SL_TRACE The message is for the tracer. 

SL CONSOLE The message will be printed to the console. 

SL_FATAL Provides a notification of a fatal error. 

SL_N0TIFY Makes a request to mail a copy of a message to the system administrator. 

The following are additional flags. These flags are not used by strerr or strace. 
Flowever, they are used to map STREAMS messages to NetTL messages as described below 
in "STREAMS-NetTL Link" section. 

SL__WARN The message is a warning. 

SL_NOTE The message is a note. 


fmt is a printf style format string. This accepts the %x, %1, %o, %u, %d, %c, and %s conversion 

specifications. 

values are numeric or character arguments for the format string. There is no maximum number of 
arguments that can be specified. 

User Interface 

User processes access the log driver with an open () call to /dev/strlog . Each open to the device will 
obtain a separate stream. After a process opens /dev/strlog, it indicates whether it is an error logger 
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or trace logger. It does this by issuing an l_STRioctl() system call with the appropriate value in the 
ic_cmd field of the strioctl structure, and the appropriate data and control information in a 
trace_ids structure: 

struct trace ids { 
short ti mid; 
short ti_sid; 
char ti_level; 
short ti_flags; 

}; 

The values for ic_cmd are: 

I__ERRLOG I ndicates an error logger. No trace_ids data is needed. 

I TRCLOG I ndicates a trace logger. A data buffer consisting of an array of one or more trace_ids 
structures must be included. 

If any of the fields of the trace_ids structure contain a value of -1, /dev/strlog will accept what¬ 
ever value it receives in that field. Otherwise, strlog only accepts messages only if the values of mid 
and sid are the same as their counterparts in the trace_ids structure, and if the message's level is 
equal to or less than the level value in the trace_ids structure. 

Once the logger process has sent the I_STR ioctl () call, the STREAMS log driver begins to send log 
messages matching the restrictions to the logger process. The logger process obtains the log messages via 
the getmsgO system call. The control part of the messages passed in this call includes a log_ctl 
structure: 


struct log_ 

_ctl { 

short 

mid; 

short 

sid; 

char 

level; 

short 

flags; 

long 

ltime; 

long 

ttime; 

int 

seq_no 

}; 



The log_ctl structure indicates the mid, sid, and lei/el time in ticks since the boot time that the mes¬ 
sage was submitted, the corresponding time in seconds sincej anuary 1, 1970, and a sequence number. The 
time in seconds sincej anuary 1, 1970 is provided so that the date and time of the message can be easily 
computed. The time in ticks since boot time is provided so that the relative timing of log messages can be 
determined. 

A user process, other than an error or trace logger, can send a log message to strlog. The driver will 
accept only the flags and level fields of the log_ctl structure in the control part of the message, 
and a properly formatted data part of the message. The data part of the message is properly formatted if it 
contains a null-terminated format string, followed by up to three arguments packed one word each after the 
end of the string. 

A different series of sequence numbers is provided for error and trace logging streams. These sequence 
numbers are intended to help track the delivery of the messages. A gap in a sequence of numbers indicates 
that the logger process did not successfully deliver them. This can happen if the logger process stops send¬ 
ing messages for one reason or another (see strace(lM) and strerr(lM) command reference pages for more 
information). The data part of messages contains text of the format string (null terminated), followed by up 
to three arguments. 

STREAMS-NetTL Link 

Both STREAMS error logging and event tracing messages are mapped to NetTL logging messages, and are 
delivered to NetTL. NetTL classifies messages into four log classes: DISASTER, ERROR, WARNING, and 
INFORMATIVE. TheNetTL log class is determined by the flags according to thefollowing rule: 

If (flags & SLERROR) NetTL logdass 
then 

if (flags & SL_FATAL) => DISASTER 
if (flags & SL_WARN) => WARNING 
if (flags & SL NOTE) => INFORMATIVE 
otherwise > ERROR 
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else 

all messages ■ ■ ■ > INFORMATIVE 

As a default, only Dl SASTER and ERROR messages are logged. This setting can be altered by the nettl 
command or the nettlconf command (see nettl (1M) and nettlconf(lM)). 

The STREAMS subsystem ID usedbyNetTL is STREAMS. 

The messages logged by NetTL facility can be formatted to a readable form by the netfmt command (see 
netfmt(lM)). The netfmt accepts a filter configuration file, which can be used to filter on STREAMS 
module ID and sub-1 D. The filter configuration file syntax for STREAMS is the following: 

STREAMS module id subjd 

modulejd and subjd can be a decimal number or "*" as a wild card. 

RETURN VALUE 

U nless specified otherwise, upon successful completion, the strlog ioctl() commands return a value 
of 0 (zero). Otherwise, a value of -1 is returned. 

ERRORS 

If any of the following conditions occurs, strlog driver's ioctl() command sets errno to the 
corresponding value: 

[ENXIO] The I_TRCLOG ioctl() call did not contain any trace_ids structures. 

[ENXIO] The I_STR ioctl () call could not be recognized. 

The driver does not return any errors for incorrectly formatted messages that user processes send. 

EXAMPLES 

The foil owing examples illustrate some basic uses for the strlog interface. 

This code example segment shows how a STREAMS module causes a message to be printed to the console: 

strlog(TMUX,minor(mydev),0,SL_CONSOLE|SL_FATAL, 

"TMUX driver (minor:%d) suffers resource shortage.", 
minor(mydev)); 

This code example shows how a user process registers itself with the STREAMS log driver using the 
ioctl () command, I_ERRLOG. 

struct strioctl iocerr: 
int logfd; 

if ((logfd = open("/dev/strlog", O RDWR) ) == —1) ( 

printf("Cannot open /dev/strlog\n") ; 
exit(1); 

) 

iocerr.ic_cmd = I ERRLOG; 
iocerr.ic_timout = 0; 
iocerr.ic_len = 0; 
iocerr.ic_dp = NULL; 
ioctl(logfd, I_STR, Siocerr); 

This code example shows a user-level process sendi ng a message to the strlog driver. 

struct strbuf control, data; 
struct log_ctl log; 

char *warning = "Fatal error for user level process"; 
int logfd; 

if ((logfd = open("/dev/strlog", O RDWR) ) == —1) ( 

printf("Cannot open /dev/strlog\n"); 
exit(1); 

) 

control.len = control.maxlen = sizeof(log); 
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control.buf = (char *)Slc; 

data.len = data.maxlen = strlen(warning); 
data.buf = warning; 

1c.level - 2; 

lc.flags = SL_FATAL|SL_CONSOLE; 
putmsg(logfd, Scontrol, Sdata, 0); 

The following examples illustrate how to use the NetTL facility for the STREAMS. See nettl(lM), 
netfmt(lM), nettlconf(lM) for the general NetTL usage. The STREAMS subsystem ID used by NetTL is 

STREAMS. 

The netfmt accepts a filter configuration file as a command argument. The following filter configuration 
file example is used to format the messages whose module ID is 1 and sub-ID is 100: 

STREAMS 1 100 

This filter configuration file example can be used to display all the messages whose module ID is 2 and all 
the messages whose sub-1 D is 101: 

STREAMS 2 * 

STREAMS * 101 

FILES 

/dev/strlog specifies the clone interface. 

<sys/strlog. h> specifies the header file for streams logging. 

<stropts.h> specifies the header file for STREAMS options and ioctl() commands. 

SEE ALSO 

strace(lM), strerr(lM), clone(7) : streamio(7), getmsg(2), putmsg(2), write(2), open(2), ioctl(2), nettl(lM), 
netfmt(lM), nettlconf(lM). 
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NAME 

stty - terminal interface for Version 6/PWB compatibility 

REMARKS 

These facilities are included to aid in conversion of old programs, and should not be used in new code. Use 
the interface described in termio(7). Note that these conversions do not work for programs ported from 
UNIX Time-Sharing System, Seventh Edition (Version 7), because some V7 flags are defined differently. 

DESCRIPTION 

These routines attempt to map theUNix Time-Sharing System, Sixth Edition (Version 6), and pwb stty and 
gtty calls into the current ioctls that perform the same functions. The mapping cannot be perfect. The way 
the features are translated is described below. The reader should be familiar with termio(7) before study¬ 
ing this entry. 

The following data structure is defined in the include file <sgtty.h>: 

struct sgttyb { 

char sg ispeed; /* input speed */ 

char sg ospeed; /* output speed */ 

char sg erase; /* erase character */ 

char sg kill; /* kill character */ 

int sg flags; /* mode flags */ 

) 

The flags, as defined in sgtty.h, are: 

fdefine HUPCL 01 

fdefine XTABS 02 

fdefine LCASE 04 

fdefine ECHO 010 

fdefine CRMOD 020 

fdefine RAW 040 

fdefine ODDP 0100 

fdefine EVENP 0200 

fdefine ANYP 0300 

fdefine NLDELAY 001400 

fdefine TBDELAY 002000 

fdefine CRDELAY 030000 

fdefine VTDELAY 040000 

fdefine BSDELAY 0100000 


#define CR0 0 

#define CR1 010000 

fdefine CR2 020000 

fdefine CR3 030000 

fdefine NL0 0 

#define NL1 000400 

fdefine NL2 001000 

fdefine NL3 001400 

fdefine TAB0 0 

#define TAB1 002000 

fdefine NOAL 004000 

#define FF0 0 

#define FF1 040000 

#define BS0 0 

fdefine BS1 0100000 


When the stty(2) command (ioctl tiocsetp) is executed, the flags in the old sgttyb structure are mapped 
into their new equivalents in the termio structure. Then theTCSETA command is executed. 

The following table shows the mapping between the old sgttyb flags and the current termio flags. Note 
that flags contained in the termio structure that are not mentioned below are cleared. 
hupcl (if set) sets the termio hupcl flag; 

hupcl (if clear) clearsthetermioHUPCL flag; 
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xtabs (if set) sets the termioTAB3 flag; 

xtabs (if clear) clears the termioTAB3 flag; 

tbde lay (if set) sets the termioTABi flag; 

tbde lay (if dear) clears the termioTABi flag; 

lcase (if set) sets the termiolUCLC, olcuc, andxCASE flags; 

lcase (if clear) clears the termiolUCLC, OLCUC, andxCASE flags; 

echo (if set) sets the termio echo flag; 

echo (if clear) clears the termio echo flag; 

noal (if set) sets the termio echok flag; 

noal (if clear) clears the termio echok flag; 

CRMOD (if set) sets the termio icrnl and ONLCR flags; also, if CRi is set, the termio CRi flag is 

set, and ifCR2 is set, the termio onocr and CR2 flags are set; 
crmod (if clear) sets the termio ONLRET flag; also, if nli is set, the termio CRi flag is set, and if 

NL2 is set, the termio CR2 flag is set; 

raw (if set) sets the termio CS8 flag, and clears the termio icrnl and iuclc flags; also, default 

values of 6 characters and 0.1 seconds are assigned to MIN and TIME, respectively; 
raw (if clear) sets the termio brkint, ignpar, istrip, ixon, ixany, opost, CS7, parenb, 

icanon, and I Si G flags; also, the default values control-D and null are assigned to the con¬ 
trol characters EOF andEOL, respectively; 

oddp (if set) if evenp is also set, clears the termio inpck flag; otherwise, sets the termio 

PARODD flag; 

vtde lay (if set) sets the termio ffdly flag; 
vtdelay (if dear) clears the termio ffdly flag; 
bsde lay (if set) sets the termio bsdly flag; 
bsde lay (if dear) clears the termio bsdly flag. 

I n addition, the termio CRE ad bit is set, and, if the baud rate is 110, theCSTOPB bit is set. 

When using tiocsetp, the ispead entry in the sgttyb structure is mapped into the appropriate speed in 
the termio cbaud field. The erase and kill sgttyb entries are mapped into the termio erase and kill char¬ 
acters. 

When thegtty(2) (ioctl tiocgetp) command is executed, the termio(7) tcgeta command is first executed. 
The resulting termio structure is then mapped into the sgttyb structure, which is then returned to the 
user. 


The following table shows how the termio flags are mapped into the old sgttyb structure. Note that all 
flags contained in the sgttyb structure that are not mentioned below are cleared. 

H u pcl (if set) sets the sgttyb H u pcl flag; 

hupcl (if clear) clears the sgttyb hupcl flag; 

icanon (if set) sets the sgttyb raw flag; 

icanon (if clear) clears the sgttyb raw flag; 

xcase (if set) sets the sgttyb lcase flag; 

xcase (if clear) clears the sgttyb lcase flag; 

echo (if set) sets the sgttyb echo flag; 

echo (if clear) clears the sgttyb echo flag; 

echok (if set) sets the sgttyb noal flag; 

echok (if clear) clears the sgttyb noal flag; 

parodd (if set) sets the sgttyb oddp flag; 
parodd (if clear) clears the sgttyb oddp flag; 
inpck (if set) sets the sgttyb evenp flag; 

PARODD, INPCK (if both clear) sets the sgttyb ODDP and EVENP flags; 

onlcr (if set) sets the sgttyb crmod flag; also, if CRi is set, the sgttyb CRi flag is set, and if CR2 

is set, the sgttyb CR2 flag is set; 

onlcr (if clear) if CRi is set, the sgttyb nli flag is set, and if CR2 is set, the sgttyb NL2 flag is set; 

TAB3 (if set) sets the sgttyb xtabs flag; 

TAB3 (if clear) clears the sgttyb xtabs flag; 

tabi (if set) sets the sgttyb tbde lay flag; 

tabi (if clear) clears the sgttybTBDELAY flag; 

F F dly (if set) sets the sgttyb vtde lay flag; 

ffdly (if clear) clears the sgttyb vtde lay flag; 

bsdly (if set) sets the sgttyb bsde lay flag; 

bsdly (if clear) clears the sgttyb bsde lay flag. 
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When using tiocgetp, the termioCBAUD field is mapped into the ispeed and ospeed entries of the sgttyb 
structure. Also, the termio erase and kill characters are mapped into the erase and kill sgttyb entries. 

Note that, since there is not a one-to-one mapping between the sgttyb and termio structures, unexpected 
results may occur when using the older tiocsetp and tiocgetp calls. Thus, the tiocsetp and 
tiocgetp calls should be replaced in all future code by the current equivalents, tcseta and tcgeta, 
respectively. 

SEE ALSO 

stty(2), termio(7). 
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NAME 

TCP - Internet Transmission Control Protocol 

SYNOPSIS 

#include <sys/socket.h> 

#include <netinet/in.h> 

#include <netinet/tcp.h> 

s = socket(AF_INET, SOCK_S TREAM, 0); 

DESCRIPTION 

TheTCP protocol provides reliable, flow-controlled, two-way transmission of data. It is a byte-stream proto¬ 
col used to support the S OCK_S TRE AM socket type. TCP constructs virtual circuits between peer entities. 
A virtual circuit consists of remote Internet addresses, remote ports, local Internet addresses and local 
ports, ip uses the I nternet addresses to direct messages between hosts, and the port numbers to identify a 
TCP entity at a particular host. 

Sockets using TCP are either active or passive, connect () creates active sockets, which initiate con¬ 
nections to passive sockets (see connect(2)). To create a passive socket, use the listen () system call 
after binding the socket with the bind() system call (see I i sten (2) and bind(2)). Only passive sockets can 
use the accept () call to accept incoming connections (see accept(2)). 

Passive sockets can underspecify their location to match incoming connection requests from multiple net¬ 
works. This technique, called wildcard addressing, allowsa singleserver to provide service to clients on 
multiple networks. To create a socket that listens on all networks, the Internet address I NAD D R_AN Y 
must be bound. TheTCP port can still be specified even if wildcard addressing is being used. If the port is 
specified as zero, the system assigns a port. 

Once accept () has a rendezvous with a connect request, a virtual circuit is established between peer 
entities. bind() supplies the local port and local I nternet address and accept() gathers the remote 
port and remote I nternet address from the peer requesting the connection. 

The system supports four socket options: TCP__MAXSEG, TCP_NODELAY, TCP_ABORT_THRESHOLD, 
and TCP_CONN_ABORT_THRESHOLD (defined in the include file <netinet/tcp. h>). 
TCPMAXSEG option can only be used with getsockopt () , while TCP_NODELAY, 
TCP_ABORT_THRESHOLD, and TCP_CONN_ABORT_THRESHOLD can beset with setsockopt() 
and tested with getsockopt () (see getsockopt(2)). These four options require lei/el to be set to 
IPPROTO__TCP in the getsockopt/setsockopt call. 

TCP MAXSEG (non-boolean option) lets an application to receive the current segment size 

of the TCP SOCKSTREAM socket. The current segment size will be 
returned in optval. 

TCP_NODELAY (boolean option) causes small amounts of output to be sent immediately. 

TCP_ABORT_THRESHOLD 

(non-boolean option) sets the second threshold timer for the connections 
that are in E STAB LI SHED state. The option value is the threshold time in 
milliseconds. 

When it must retransmit packets because a timer has expired, TCP first 
compares the total time it has waited against the two thresholds, as 
described in RFC 1122, 4.23.5. If it has waited longer than the second 
threshold (R2), TCP terminates the connection. The default value for this 
option is the current value of the ndd tunable parameter 
tcp_ip_abort_interval. Refer to ndd(lM) online help for detailson 
the tcp_ip_abort_interval default value. 

TCP_CONN_ABORT_THRESHOLD 

(non-boolean option) sets the second threshold timer during connection 
establishment. The option valueisthethresholdtimein milliseconds. 

This option is the same as TCP_ABORT_THRESHOLD, except that this 
value is used during connection establishment. When it must retransmit 
the SYN packet because a timer has expired, TCP first compares the total 
time it has waited against the two thresholds. If it has waited longer than 
the second threshold, TCP terminates the connection. The default value for 
this option is the current value of the ndd tunable 
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tcp_ip_abort_cinterval. See ndd(lM) online help for details on 
thetcp_ip_abort_cinterval default value. 

If TCP_NODELAY is set, the system sends small amounts of output immediately rather than gathering 
them into a single packet after an acknowledgement is received. If TCP_NODELAY is not set, the system 
sends data when it is presented, if there is no outstanding unacknowledged data. If there is outstanding 
unacknowledged data, the system gathers small amounts of data to be sent in a single packet once an ack¬ 
nowledgement is received. For clients such as window managers that send a stream of mouse events which 
receive no replies, this packetization may cause significant delays. The TCP_NODELAY option can be used 
to avoid this situation. Note, however, that setting the TCP_NODELAY option may result in a large 
number of small packets being sent over the network. 

By default, TCP_NODELAY is not set when a socket is created. 

The option level to use for accessing theTCP option with the setsockopt() or getsockopt() calls 
is the protocol number for TCP which is availablefrom getprotobyname () (see getprotoent(3N)). 

If the SO KEEPALIVE socket option is enabled on an established TCP connection and the connection has 
been idle for two hours, TCP sends a packet to the remote socket, expecting the remote TCP to ack¬ 
nowledge that the connection is still active. If the remote TCP does not respond in a timely manner, TCP 
continues to send keepalive packets according to its normal retransmission algorithm. If the remote TCP 
does not respond within a particular time limit, TCP drops the connection. The next socket system call (for 
example, recv() ) returns an error, and errno is set to ETIMEDOUT. See getsockopt(2) for detailson 
enabling SO_KEEPALlVE. 

The maximum buffer size for a TCP stream socket is 262142 bytes. The default buffer size is 32768 bytes 
(see WARNINGS below). The send and receive buffer sizes for TCP stream sockets can be altered by using 
the SO SNDBUF and SO_RCVBUF options of the setsockopt() system call. Refer to getsockopt(2) 
for details. 


ERRORS 

One of the following errors may be returned in errno if a socket operation fails. For a more detailed list 
of errors, see the man pages for specific system calls. 


[EISCONN] 

[ENOBUFS] 

[ETIMEDOUT] 

[ECONNRESET] 

[ECONNREFUSED] 

[EADDRINUSE] 
[EADDRNOTAVAIL] 


The socket is already connected. 

No buffer space is availablefor an internal data structure. 

Connection dropped due to excessive retransmissions. 

The connection was forcibly closed by the peer socket. 

Remote peer actively refuses connection establishment (usually because no 
process is listening to the port). 

The specified address is already in use. 

The specified address is not availableon this machine. 


WARNINGS 

The default socket buffer size might increase without notice in a future release or patch. Therefore, if an 
application calls setsockopt () with SO_RCVBUF, it should do so before calling listen() , or it 
should first call getsockopt () with SO_RCVBUF and ensure that the intended new receive buffer size 
is not less than the current buffer size. These programming conventions are consistent with TCP protocol 
restrictions against reducing theTCP receive window after a connection has been established. 


AUTHOR 

The socket interfaces to TCP were developed by the U niversity of California, Berkeley. 


SEE ALSO 

getsockopt(2), socket(2), send(2), recv(2), t_open(3), socket(7), inet(7F), ndd(lM). 


RFC 793 Transmission Control Protocol 

RFC 1122 Requirements for Internet hosts 
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NAME 

tels, telm - STREAMS Telnet slave (pseudo-terminal) driver, STREAMS Telnet master driver (used by tel - 
netd only), respectively 

SYNOPSIS 

#include <sys/termios.h> 

#include <sys/strtio.h> 

int open ( "/dev/pts/tN", 0_RDWR) ; 

DESCRIPTION 

A Telnet pseudo-terminal consists of a tightly-coupled pair of character devices, called the master device 
and slave device. The master and slave device drivers work together to provide a Telnet connection on the 
server side where the master provides a connection to telnetd and the slave provides a terminal device 
special file access for theTelnet application processes, as depicted below: 


| Pseudo terminal functions| 

Application <—> |-| <—> telnetd 

Processes | Slave | Master | 

| (tels) | (telm) | 


The slave driver, tels with ptem (STREAMS pty emulation module) and ldterm (STREAMS line dis¬ 
cipline module) pushed on top (not shown for simplicity), provides a terminal interface as described in ter- 
mio(7). Whereas devices that provide the terminal i nterface descri bed in termio(7) havea hardware device 
behind them; in contrast, the slave device has telnetd manipulating it through the master side of the 
Telnet pseudo terminal. 

There are no nodes in the file system for each individual master device. Rather, the master driver is set up 
as a STREAMS done(7) driver with its major device number set to the major for the clone driver and its 
minor device number set to the major for the telm driver. The master driver is opened by telnetd using 
the open(2) system call with /dev/telnetm as the device file parameter. The clone open finds the next 
available mi nor number for the master device. The master device is availableonly if it and its correspond¬ 
ing slave device are not already opened. 

In order to use the STREAMS Telnet subsystem, a node for the master driver /dev/telnetm and N 
number of Telnet slave devices must be installed. 

The number of slave devices is set by a kernel tunable parameter called nstrtel . This can be modified 
using SAM; its default and minimum value is 60. The value of nstrtel is the upper limit of the number 
of telnet sessions that can be opened. 

Multipleopens are allowed on theTelnet slave device. 

The master and slave drivers pass all STREAMS messages to their adjacent drivers. When the connection 
is closed from the Telnet client side, an M„HANGUP message is sent to the corresponding slave device 
which will render that slave device unusable. The process on the slave side gets the errno ENXIO when 
attempting a write(2) system call to the slave device file but it will be able to read any data remaining in 
the slave stream. Finally, when all the data has been read, the read (2) system call will return 0, indicating 
that the slave can nolonger be used. 

AUTHOR 

tels() and telm () were developed by HP. 

FILES 

/dev/telnetm Streams Telnet master clone device 

/dev/pts/tN Streams slave devices where N is the minor number of the slave device and 0 < N < 

nstrtel. 


SEE ALSO 

insf(lM), open(2), ioctl(2), streamio(7), ldterm(7), telnetd(lM), ptem(7). 
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NAME 

termio, termios - general terminal interface 

DESCRIPTION 

All hp-ux asynchronous communications ports use the same general interface, regardless of what hardware 
is involved. Network connections such as rlogin (see rlogin(l) use the pseudo-terminal interface (see 
pty(7). 

This discussion centers around the common features of this interface. 

Opening a Terminal File 

When a terminal file is opened, it normally causes the process to wait until a connection is established. In 
practice, users' programs seldom open these files; they are opened by special programs such as getty (see 
getty(lM)) and become a user's standard input, standard output, and standard error files. 

If both the 0_NDELAY and 0_N0NBL0CK flags (see open(2)) are clear, an open blocks until the type of 
modem connection requested (see modem(7)) is completed. If either the 0_NDELAY or 0_N0NBL0CK 
flag is set, an open succeeds and return immediately without waiting for the requested modem connection 
to complete. The CLOCAL flag (seeControl Modes) can also affect open(2). 

Process Groups 

A terminal can have a foreground process group associated with it. This foreground process group plays a 
special role in handling signal-generating input characters. 

Command interpreter processes can allocate the terminal to different jobs (process groups) by placing 
related processes in a single process group and associating this process group with the terminal. A 
terminal's foreground process group can be set or examined by a process, assuming that the permission 
requirements are met (see tcsetpgrp(3C) or tcgetpgrp(3C)). The terminal interface aids in this allocation by 
restricting access to the terminal by processes that are not in the foreground process group. 

A process group is considered orphaned when the parent of every member of the process group is either 
itself a member of the process group or is not a member of the group's session (see Sessions). 

Sessions 

A process that creates a session (see setsid(2) or setpgrp(2)) becomes a session leader. Every process group 
belongs to exactly one session. A process is considered to be a member of the session of which its process 
group is a member. A newly created process joins the session of its parent. A process can change its ses¬ 
sion membership (see setpgid(2) or setpgrp(2)). Usually a session comprises all the processes (including 
children) created as a result of a single login. 

The Controlling Terminal 

A terminal can belong to a process as its controlling terminal. Each process of a session that has a control¬ 
ling terminal has the same controlling terminal. A terminal can be the control ling terminal for at most one 
session. The controlling terminal for a session is allocated by the session leader. If a session leader has no 
controlling terminal and opens a terminal device file that is not already associated with a session without 
using the 0_N0CTTY option (see open (2), the terminal becomes the controlling terminal of the session and 
the controlling terminal's foreground process group is set to the process group of the session leader. While 
a controlling terminal is associated with a session, the session leader is said to be the controlling process of 
the controlling terminal. 

The controlling terminal is inherited by a child process during a fork() (see fork(2)). A process relinqu¬ 
ishes its controlling terminal if it creates a new session with setsid() or setpgrpO (see setsid(2) 
and setpgrp(2)), or when all file descriptors associated with the controlling terminal have been closed. 

When the controlling process terminates, the controlling terminal is disassociated from the current session, 
allowing it to be acquired by a new session leader. A SIGHUP signal is sent to all processes in the fore¬ 
ground process group of the controlling terminal. Subsequent access to the terminal by other processes in 
the earlier session can be denied (see Terminal Access Control) with attempts to access the terminal treated 
as if a modem disconnect had been sensed. 

Terminal Access Control 

Read operations are allowed (see Input Processing and Reading Data) from processes in the foreground 
process group of their controlling terminal. If a process is not in the foreground process group of its con¬ 
trolling terminal, the process and all member's of its process group are considered to be in a background 
process group of this controlling terminal. All attempts by a process in a background process group to read 
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from its controlling terminal will be denied. If denied and the reading process is ignoring or blocking the 
SIGTTIN signal, or the process (on systems that implement vfork separately from fork) has made a call to 
vfork(2) but has not yet made a call to e<ec(2), or the process group of the reading process is orphaned, 
read() returns -1 with errno set to EIO and no signal is sent. In all other cases where the read is 
denied, the process group of the reading process will besenta SIGTTIN signal. The default action of the 
SIGTTIN signal is to stop the process to which it is sent. 

If the process is in the foreground process group of its controlling terminal, write operations are allowed 
(see Writing Data and Output Processing). Attempts by a process in a background process group to write 
to its controlling terminal are denied if TOSTOP (see Local Modes) is set, the process is not ignoring and 
not blocking the SIGTTOU signal, and the process (on systems that implement vfork separately from fork) 
has not made a call to vfork(2) without making a subsequent call to o<ec(2). If the write is denied and the 
background process group is orphaned, the write () returns -1 with errno set to EIO. If the write is 
denied and the background process group is not orphaned, the SIGTTOU signal is sent to the process 
group of the writing process. The default action of the SIGTTOU signal is to stop the process to which it is 
sent. 

Certain calls that set terminal parameters are treated in the same fashion as write, except that TOSTOP is 
ignored; that is, the effect is identical to that of terminal writes when TOSTOP is set. 

Input Processing and Reading Data 

A terminal device associated with a terminal device file can operate in full-duplex mode, so that data can 
arrive, even while data output is occurring. Each terminal device file has an input queue associated with it 
into which incoming data is stored by the system before being read by a process. The system imposes a 
limit, MAX INPUT , on the number of characters that can be stored in the input queue. This limit is depen¬ 
dent on the particular implementation, but is at least 256. When the input limit is reached, all saved char¬ 
acters are discarded without notice. 

All input is processed either in canonical mode or non-canonical mode (see Canonical Mode Input Process¬ 
ing and Non-Canonical Mode Input Processing). Additionally, input characters are processed according to 
the c_iflag (see Input Modes) and c_lflag (see Local Modes) fields. For example, such processing 
can include echoing, which in general means transmitting input characters immediately back to the termi¬ 
nal when they are received from the terminal. This is useful for terminals that operate in full-duplex mode. 

The manner in which data is provided to a process reading from a terminal device file depends on whether 
the terminal device file is in canonical or non-canonical mode. 

Another dependency is whether the 0_N0NBL0CK or 0_NDELAY flag is set by either open(2) or fcntl(2). 
If the O NONBLOCK and 0__NDELAY flags are both clear, the read request is blocked until data is avail¬ 
able or a signal is received. If either the 0_N0NBL0CK or 0_NDELAY flag is set, the read request com¬ 
pletes without blocking in one of three ways: 

• If there is enough data availableto satisfy the entire request, read() completes successfully, 
having read all of the data requested, and returns the number of characters read. 

• If there is not enough data availableto satisfy the entire request, read() completes successfully, 
having read as much data as possible, and returns the number of characters read. 

• If there is no data available, read() returns -1, with errno set to EAGAIN when the 
O NONBLOCK flag is set. Otherwise, (flag 0_N0NBL0CK is clear and 0_NDELAY is set) 
read () completes successfully, having read no data, and returns a count of 0. 

The availability of data depends upon whether the input processing mode is canonical or non-canonical. 
The following sections, Canonical Mode Input Processing and Non-Canonical Mode Input Processing, 
descri be each of these i nput processi ng modes. 

Canonical Mode Input Processing (Erase and Kill Processing) 

I n canonical mode input processing, terminal input is processed in units of lines, where a line is delimited 
by a new-line(NL) character, an end-of-file (EOF) character, or an end-of-linecharacter (EOL) or(EOL2). See 
Special Characters for more information on NL, EOF, EOL, and EOL2. This means that a read request 
does not return until an entire line has been typed or a signal has been received. Also, no matter how 
many characters are requested in the read call, at most one line will be returned. It is not, however, neces¬ 
sary to read a whole line at once; any number of characters can be requested in a read, even one, without 
losing information. 

MAX_CANON is the limit on the number of characters in a line. This limit varies with each particular 
implementation, but is at least 256. 
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When the MAX_CANON limit is reached, all characters in the current undelimited line are discarded 
without notice. 

Erase and kill processing occur when any of three special characters, the erase, we rase, or kill charac¬ 
ters (see Special Characters), is received. This processing affects data in the input queue that has not yet 
been delimited by a nl, eof, eol, or EOL2 character. This undelimited data makes up the current line. 
The erase character deletes the last character in the current line, if one exists. The werase character 
deletes the last word in the current line, if one exists. A word is defined as a series of non-blank characters 
(tabs are equivalent to blanks). The kill character deletes all data in the current line, if any, and option¬ 
ally outputs a new-line (NL) character. These characters operate on a key-stroke basis, independent of any 
backspacing or tabbing that may have preceded them, erase, werase, and kill characters have no effect 
if the current line is empty, erase, werase, and kill characters are not placed in the input queue. 

Non-Canonical Mode Input Processing (MIN/TIME Interaction) 

In non-canonical mode input processing, input characters are not assembled into lines, and erase and kill 
processing does not occur. The values of the MIN and TIME members of the c_cc array (see termios 
Structure) are used to determine how to process the characters received. MIN represents the minimum 
number of characters that should be received before read() successfully returns, time is a timer of 0.10 
second granularity that is used to timeout bursty and short term data transmissions. The four possible 
cases for min and time and their interactions are described below. 

Case A: MIN >0, TIME >0 

In this case, time serves as an inter-character timer and is activated after the first character is received. 
Since it is an inter-character timer, it is reset after each character is received. The interaction between 
MIN and TIME isas follows: 

• As soon as one character is received, the inter-character timer is started. 

• If min characters are received before the inter-character timer expires (remember that the timer is 
reset upon receipt of each character), the read is satisfied. If the timer expires beforeMiN charac¬ 
ters are received, the characters received to that point are returned to the user. 

• Note that if time expires, at least one character will be returned because the timer would not have 
been enabled unless a character was received. In this case ( min >0, time >0 ) the read blocks 
until theMiN and time mechanisms are activated by the receipt of thefirst character, or a signal is 
received. 

Case B: MIN >0, TIME =0 

In this case, since the valueof time is zero, the timer plays no role and only min is significant. A pending 
read is not satisfied until min characters are received after any previous read completes (that is, the pend¬ 
ing read blocks until min characters are received), or a signal is received. A program that uses this case to 
handle record-based terminal I/O can block indefinitely in the read operation. 

CaseC: MIN =0,TIME >0 

In this case, since the value of min is zero, time no longer represents an inter-character timer. It now 
serves as a read timer that is activated as soon as the read() function is processed. A read is satisfied as 
soon as a single character is received or the read timer expires. If the timer expires, no character is 
returned. If the timer does not expire, the only way the read can be satisfied is by a character being 
received. A read cannot block indefinitely waiting for a character because if no character is received within 
time x 0.10 seconds after the read is initiated, read() returns a valueof zero, having read no data. 

CaseD: MIN =0, TIME =0 

The number of characters requested or the number of characters currently available, whichever is less, is 
returned without waiting for more characters to be input. If no characters are available, read() returns 
a valueof zero, having read no data. 

Some points to note about min andTiME: 

1. In the above explanations, the interactions of min and time are not symmetric. For example, 
when min >0 and time =0, time has no effect. Flowever, in the opposite case where min =0 and 
time >0, both min and time play a role in that min is satisfied with the receipt of a single char¬ 
acter. 

2. Also note that in case A (min >0, time >0 ), time represents an inter-character timer while in 
caseC (min =0, time >0), time represents a read timer. 
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These two points highlight the dual purpose of the Ml n/ti me feature. CasesAandB (whereMiN >0)exist 
to handle burst mode activity (such as file transfer programs) where a program would like to process at 
least min characters at a time. In case A, the inter-character timer is activated by a user as a safety meas¬ 
ure while in case B it is turned off. 

Cases C and D exist to handle single character timed transfers. These cases are readily adaptable to 
screen-based applications that need to know if a character is present in the input queue before refreshing 
the screen. In caseC the read istimed, whilein caseD it isnot. 

Another important note is that min is always just a minimum. It does not denote a record length. For 
example, if a program initiates a read of 20 characters when min is 10 and 25 characters are present, 20 
characters will be returned to the user. FI ad the program requested all characters, all 25 characters would 
be returned to the user. 

Furthermore, if time is greater than zero and min is greater than MAX_INPUT, the read will never ter¬ 
minate as a result of min characters being received because all the saved characters are discarded without 
notice when MAX_INPUT isexceeded. IfTiME iszeroandMiN is greater than MAX_INPUT , the read will 
never terminate unless a signal is received. 

Special Characters 

Certain characters have special functions on input, output, or both. U nless specifically denied, each special 
character can be changed or disabled. To disable a character, set its value to _P0SIX_VDISABLE (see 
unistd(5)). These special functions and their default character values are: 

Intr (Rubout or ascii del) special character on input and is recognized if ISIG (see Local 

Modes) is enabled. Generates a SIGINT signal which is sent to all processes in the 
foreground process group for which the terminal is the controlling terminal. Normally, 
each such process is forced to terminate, but arrangements can be made to either ignore 
or hold the signal, or to receive a trap to an agreed-upon location; see signal (2) and sig¬ 
nal®. If ISIG is set, theiNTR character is discarded when processed. If ISIG is 
clear, theiNTR character is processed as a normal data character, and no signal is sent. 

quit (Ctrl-1 or ascii FS) special character on input. Recognized if ISIG (see Local Modes) is 

set. The treatment of this character is identical to that of the intr character except 
that a SIGQUIT signal is generated and the processes that receive this signal are not 
only terminated, but a core image file (called core) is created in the current working 
directory if the implementation supports core files. 

SWTCH (ascii nul) special character on input and is only used by the shell layers facility shl (1). 

The shell layers facility is not part of the general terminal interface. No special func¬ 
tions are performed by the general terminal interface when SWTCH characters are 
encountered. 

erase (#) special character on input and is recognized if ICANON (see Local Modes) is 

enabled. Erases the preceding character. Does not erase beyond the start of a line, as 
delimited by a nl, EOF, eol, or EOL2 character. If ICANON is enabled, the erase char¬ 
acter is discarded when processed. If ICANON is not enabled, the erase character is 
treated as a normal data character. 

werase (disabled) special character on input and is recognized if ICANON (see Local Modes) is 

enabled. Erases the preceding word. Does not erase beyond the start of a line, as del¬ 
imited by a nl, EOF, eol, or EOL2 character. If ICANON is enabled, the werase char¬ 
acter is discarded when processed. If ICANON is not enabled, the werase character is 
treated as a normal data character. 

kill (@) special character on input and is recognized if ICANON is enabled, kill deletes the 

entire line, as delimited by a nl, EOF, eol, or EOL2 character. If ICANON is enabled, 
the kill character is discarded when processed. If ICANON is not enabled, the kill 
character is treated as a normal data character. 

EOF (Control-D or ascii EOT) special character on input and is recognized if ICANON is 

enabled. EOF can be used to generate an end-of-filefrom a terminal. When received, all 
the characters waiting to be read are immediately passed to the program without wait¬ 
ing for a new-line, and the EOF is discarded. Thus, if there are no characters waiting, 
(that is, the EOF occurred at the beginning of a line) a character count of zero is 
returned from read(), representing an end-of-file indication. If ICANON is enabled, 
the EOF character is discarded when processed. If ICANON is not enabled, the EOF 
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character is treated as a normal data character. 

nl (ascii LF) special character on input and is recognized if ICANON flag is enabled. It is 

the line delimiter (\n). If ICANON is not enabled, the nl character is treated as a nor¬ 
mal data character. 

eol (ascii nul) special character on input and is recognized if ICANON is enabled, eol is 

an additional line delimiter similar to nl. It is not normally used. If ICANON is not 
enabled, the EOL character is treated as a normal data character. 

EOL2 (disabled) special character on input and is recognized if ICANON is enabled. EOL2 is 

an additional line delimiter similar to eol. It is not normally used. If ICANON is not 
enabled, the EOL2 character is treated as a normal data character. 

SUSP (disabled) special character recognized on input. If ISIG is enabled, receipt of the 

SUSP character causes a SIGTSTP signal to be sent to all processes in the foreground 
process group for which theterminal is the controlling terminal, and thesusp character 
is discarded when processed. If ISIG is not enabled, thesusp character is treated as a 
normal data character. Command interpreter processes typically set SUSP to Control-Z. 

dsusp (disabled) special character recognized on input. If ISIG is enabled, and a process in 

the foreground process group attempts to read the dsusp character, a SIGTSTP signal 
is sent to all processes in the foreground process group for which theterminal is the con¬ 
trolling terminal, and the dsusp character is then discarded. If ISIG is not enabled, 
the dsusp character is treated as a normal data character. Note that dsusp is similar 
to SUSP except that the signal is sent when a process in the foreground process group 
attempts to read the dsusp character, rather than when it is typed. 

stop (Control-S or ascii DC3) special character on both input and output. If IXON (output 

control) is enabled, processing of theSTOP character temporarily suspends output to the 
terminal device. This is useful with CRT terminals to prevent output from disappearing 
before it can be read. While output is suspended and IXON is enabled, stop characters 
are ignored and not read. If IXON is enabled, theSTOP character is discarded when 
processed. If IXON is not enabled, theSTOP character is treated as a normal data char¬ 
acter. If IXOFF (input control) is enabled, the system sends a stop character to the 
terminal device when the number of unread characters in the input queue is approach¬ 
ing a system specified limit. This is an attempt to prevent this buffer from overflowing 
by telling theterminal device to stop sending data. 

start (Control-Q or ascii DCi) special character on both input and output. If IXON (output 

control) is enabled, processing of the start character resumes output that has been 
suspended. While output is not suspended and IXON is enabled, start characters are 
ignored and not read. If IXON is enabled, the start character is discarded when pro¬ 
cessed. If IXON is not enabled, the start character is treated as a normal data charac¬ 
ter. If ixoff (input control) is enabled, the system sends a start character to the ter¬ 
minal device when the input queue has drained to a certain system-defined level. This 
occurs when the input queue is no longer in danger of possibly overflowing. 

CR (ascii CR) special character on input is recognized if ICANON is enabled. When 

ICANON and ICRNL are enabled and IGNCR is not enabled, this character is 
translated into a nl, and has the same affect as the nl character. If ICANON and 
IGNCR are enabled, the CR character is ignored. If ICANON is enabled and both 
ICRNL and IGNCR are not enabled, theCR character is treated as a normal data char¬ 
acter. 

lnext (disabled) special character recognized on input. Causes the special meaning of the next 

character to be ignored. This works for all special characters specified above. It allows 
characters to be input that would otherwise be interpreted by the system for a special 
function. 

The special characters are assigned their default character values when the terminal port is opened. The 
default values used are those specified by the System V I nterface Definition, Third Edition (SVID3), except 
fortheWERASE (Ctrl-W) and lnext (Ctrl-V) characters which are set to _POSIX_VDI SABLE to maintain 
binary compatibility with previous releases of HP-UX. The default character values assigned when the port 
is opened can be changed for all ports on a system wide basis through the use of the stty command (see 
stty(l)). The character values may also be changed for a specific port after it is opened using the stty 
command. The nl and CR characters cannot be changed or disabled. The character values for the 
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remaining special characters can be changed or disabled to suit individual tastes. 

If ICANON is set (see Local Modes), theERASE, kill, and EOF characters can be escaped by a preceding \ 
character, in which case no special function is performed. These characters, and the remaining special 
characters, may also be escaped by preceding them with theLNEXT character (see lnext above). 

If two or more special characters have the same value, the function performed when the character is pro¬ 
cessed is undefined. 

Modem Disconnect 

If a modem disconnect is detected by the terminal interface for a controlling terminal, and if CLOCAL is 
clear in the c_cflag field for the terminal (see Control Modes), the SIGHUP signal is sent to the con¬ 
trolling process of the controlling terminal. Unless other arrangements have been made, this causes the 
controlling process to terminate. Any subsequent read from the terminal device returns with an end-of-file 
indication until the device is closed. Thus, processes that read a terminal file and test for end-of-file can 
terminate appropriately after a disconnect. Any subsequent write () to the terminal device returns-1, 
with errno set to EIO, until the device is closed. 

Closing a Terminal Device File 

The last process to close a terminal device file causes any output not already sent to the device to be sent to 
the device even if output was suspended. This last close always blocks (even if non-blocking I/O has been 
specified) until all output has been sent to the terminal device. Any input that has been received but not 
read is discarded. 


Writing Data and Output Processing 

When characters are written, they are placed on the output queue. Characters on the output queue are 
transmitted to the terminal as soon as previously-written characters are sent. These characters are pro¬ 
cessed according to the c_oflag field (see Output Modes). I nput characters are echoed by putting them 
in the output queue as they arrive. If a process produces characters for output more rapidly than they can 
be sent, the process is suspended when its output queue exceeds some limit. When the queue has drained 
down to some threshold, the process is resumed. 


termios Structure 

Routines that need to control certain terminal I/O characteristics can do so by using the termios struc¬ 
ture as defined in the header file <termios . h >. The structure is defined as follows: 


#define NCCS 
struct termios 
tcflag t 
tcflag_t 
tcflag t 
tcflag_t 
tcflag_t 
cc_t 


16 

{ 

c_iflag; 
c_oflag; 
c_cflag; 
c_.lf lag; 
preserved; 
c_cc[NCCS]; 


/* input modes */ 

/* output modes */ 

/* control modes */ 

/* local modes */ 

/* reserved for future use */ 
/* control chars */ 


The special characters are defined by the array c_cc. The relative positions and default values for each 
special character function are as follows: 


INTR 

QUIT 

ERASE 

KILL 

EOF 

EOL 

EOL2 

MIN 

TIME 

SUSP 

START 

STOP 

WERASE 

LN EXT 

DSUSP 


VI NTR 

VQUIT 

VERASE 

VKILL 

VEOF 

VEOL 

VEOL2 

VMIN 

VTIME 

VSUSP 

VSTART 

VSTOP 

VWERASE 

VLNEXT 

VDSUSP 


DEL 

Control-| 

# 

@ 

Control-D 

NUL 

disabled 

NUL 

Control-D 

disabled 

Control-Q 

Control-S 

disabled 

disabl ed 

disabled 
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termio Structure 

The termio structure has been superseded by the termios structure and is provided for backward 
compatibility with prior applications (see termio Caveats). The structure is defined in the header file 
<termio .h>and isdefined as follows: 

fdefine NCC 8 


termio { 
unsigned 

short 

c_iflag; 

/* 

input modes */ 

unsigned 

short 

c_oflag; 

/* 

output modes */ 

unsigned 

short 

c_cflag; 

/* 

control modes */ 

unsigned 

short 

c_lflag; 

/* 

local modes */ 

char 


c_line; 

/* 

line discipline */ 

unsigned 

char 

c_cc[NCC]; 

/* 

control chars */ 


Modes 

The next four sections describe the specific terminal characteristics that can beset using the termios and 
termio structures (see termio Caveats). Any bits in the modes fields that are not explicitly defined below 
are ignored. However, they should always be clear to prevent future compatibility problems. 


Input Modes 

The c_iflag field describes the basic terminal input control: 


IGNBRK 

Ignore break condition. 

BRKINT 

Signal interrupt on break. 

IGNPAR 

1 gnore characters with parity errors. 

PARMRK 

Mark parity errors. 

INPCK 

Enableinput parity check. 

ISTRIP 

Strip character. 

INLCR 

MapNL toCR on input. 

IGNCR 

1 gnore cr. 

ICRNL 

MapCR to NL on input. 

IUCLC 

Map uppercase to lowercase on input. 

IXON 

Enablestart/stop output control. 

IXANY 

Enable any character to restart output. 

IXOFF 

Enablestart/stop input control. 

IMAXBEL 

EnableBEL on input linetoo long. 


A break condition is defined as a sequence of zero-value bits that continues for more than the time to send 
one character. For example, a character framing or parity error with data all zeros is interpreted as a sin¬ 
gle break condition. 

If IGNBRK is set, the break condition is ignored. Therefore the break condition cannot be read by any pro¬ 
cess. If IGNBRK is clear and BRKINT is set, the break condition flushes both the input and output 
queues and, if the terminal is the controlling terminal of a foreground process group, the break condition 
generates a single SIGINT signal to that foreground process group. If neither IGNBRK nor BRKINT is 
set, a break condition is read as a single \0 character, or if PARMRK is set, as the three-character 
sequence\377, \0, \0. 

If IGNPAR is set, characters with other framing and parity errors (other than break) are ignored. 

If PARMRK is set, and IGNPAR is clear, a character with a framing or parity error (other than break) is 
read as the three-character sequence: \377, \0, X, where X is the data of the character received in error. 
To avoid ambiguity in this case, if ISTRIP is clear, a valid character of \377 is read as \377, \377. If 
both PARMRK and IGNPAR are clear, a framing or parity error (other than break) is read as the character 
\ 0 . 

If INPCK is set, input parity checking is enabled. If INPCK is clear, input parity checking is disabled. 
Whether input parity checking is enabled or disabled is independent of whether parity detection is enabled 
or disabled (see Control Modes). If PARENB is set (see Control Modes)and INPCK isdear, parity genera¬ 
tion is enabled but input parity checking is disabled; the hardware to which the terminal is connected will 
recognize the parity bit, but the terminal special file will not check whether this bit is set correctly or not. 

The following table shows the interrelationship between the flags IGNBRK, BRKINT, IGNPAR, and 
PARMRK. The column marked Input gives various types of input characters received, indicated as follows: 
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0 nul character (\0) 

C Character other than nul 

P Parity error detected 

F Framing error detected 

Items enclosed in brackets indicate one or more of the conditions are true. 

If the INPCK flag is clear, characters received with parity errors are not processed according to this table, 
but instead, as if no parity error had occurred. Under the flag columns, Set indicates the flag is set, 
Clear indicates the flag is not set, and X indicates the flag may be set or clear. The column labeled 
Read shows the results that will be passed to the application code. A — indicates that no character or con¬ 
dition is passed to the application code. The value SIGINT indicates that no character is returned, but 
that the SIGINT signal is sent to the foreground process group of the controlling terminal. 


1 nput 

IGNBRK 

BRKINT 

IGNPAR 

PARMRK 

Read 

0[PF] 

Set 

X 

X 

X 

— 

0[PF] 

Clear 

Set 

X 

X 

SIGINT 

0[PF] 

Clear 

Clear 

X 

Set 

A 377'A O'A 0' 

0[PF] 

Clear 

Clear 

X 

Clear 

\0’ 

C[PF] 

X 

X 

Set 

X 

— 

C[PF] 

X 

X 

Clear 

Set 

A 377'A 0’,C 

C[PF] 

X 

X 

Clear 

Clear 

\0' 

\ 377' 

X 

X 

X 

Set 

A 377'A 377' 


If ISTRIP is set, valid input characters are first stripped to 7-bits, otherwise all 8-bits are processed. 

If INLCR is set, a received nl character is translated into a cr character. If IGNCR is set, a received CR 
character is ignored (not read). If IGNCR is clear and ICRNL is set, a received CR character is translated 
into a nl character. 

If IUCLC is set, a received uppercase alphabetic character is translated into the corresponding lowercase 
character. 

If IXON is set, start/stop output control is enabled. A received stop character suspends output and a 
received start character restarts output. If IXANY and IXON are set, any input character without a 
framing or parity error restarts output that has been suspended. When these three flags are set, output 
suspended, and an input character received with a framing or parity error, output resumes if processing it 
results in data being read. When IXON is set, start and stop characters are not read, but merely per¬ 
form flow control functions. When IXON is clear, theSTART and stop characters are read. 

If IXOFF is set, start/stop input control is enabled. The system transmits a stop character when the 
number of characters in the input queue exceeds a system defined value (high water mark). This is 
intended to cause the terminal device to stop transmitting data in order to prevent the number of charac¬ 
ters in the input queue from exceeding MAX_INPUT. When enough characters have been read from the 
input queue that the number of characters remaining is less than another system defined value (low water 
mark), the system transmits a start character which is intended to cause the terminal device to resume 
transmitting data (without risk of overflowing the input queue). In order to avoid potential deadlock, 
IXOFF is ignored in canonical mode whenever there is no line delimiter in the input buffer. In this case, 
the stop character is not sent at the high water mark, but will be transmitted later if a delimiter is 
received. If all complete lines are read from the input queue leaving only a partial line with no linedelim- 
iter, theSTART character is sent, even if the number of characters is still greater than the low water mark. 
When ICANON is set and the input stream contains more characters between line deli miters than the high 
water mark allows, there is no guarantee that IXOFF can prevent buffer overflow and data loss, because 
the stop character may not be sent in time, if at all. 

If IMAXBEL is set, the ascii bel character is echoed if the input queue overflows. Further input is not 
stored, but any input present in the input queue is not discarded. If IMAXBEL is clear, noASCh bel char¬ 
acter is echoed, and the input already present in the input queue is discarded when the input queue 
overflows. 

The initial input control value is all bits clear. 

Output Modes 

The c_of lag field specifies the system treatment of output: 

OPOST Postprocess output. 
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OLCUC 

Map lowercase to uppercase on output. 

ONLCR 

MapNL to CR-NL on output. 

OCRNL 

MapCR to NL on output. 

ONOCR 

NoCR output at column 0. 

ONLRET 

nl performs CR function. 

OFILL 

Use fill characters for delay. 

OFDEL 

Fill is del, elseNUL. 

NLDLY 

Select new-line delays: 

NLO 

No delay 

NL1 

Delay type 1 

CRDLY 

Select carriage-return delays: 

CRO 

No delay 

CR1 

Delay type 1 

CR2 

Delay type 2 

CR3 

Delay type 3 

TABDLY 

Select horizontal-tab delays: 

TABO 

No delay 

TAB1 

Delay type 1 

TAB 2 

Delay type 2 

TAB 3 

Expand tabs to spaces. 

XTABS 

Expand tabs to spaces. 

BSDLY 

Select backspace delays: 

BSO 

No delay 

BS1 

Delay type 1 

VTDLY 

Select vertical-tab delays: 

VTO 

No delay 

VT1 

Delay type 1 

FFDLY 

Select form-feed delays: 

FFO 

No delay 

FF1 

Delay type 1 


If OPOST is set, output characters are post-processed as indicated by the remaining flags; otherwise char¬ 
acters are transmitted without change. 

If OLCUC isset, a lowercase alphabetic character is transmitted as the corresponding uppercase character. 
Thisfunction is often used in conjunction with IUCLC. 

If ONLCR is set, the nl character is transmitted as the CR-nl character pair. If OCRNL is set, the CR 
character is transmitted as the nl character. If ONOCR is set, no cr character is transmitted when at 
column 0 (first position). If ONLRET isset, the nl character is assumed to do the carriage-return function; 
the column pointer will be set to 0, and the delays specified for CR will be used. If ONLRET is clear, theNL 
character is assumed to perform only the line-feed function; the delays specified for nl are used and the 
column pointer remains unchanged. For all of these cases, the column pointer is always set to 0 if theCR 
character is actually transmitted. 

The delay bits specify how long transmission stops to allow for mechanical or other movement when certain 
characters are sent to the terminal. The values of NLO, CRO, TABO, BSO, VTO, and ffo indicate no delay. 
If OFILL is set, fill characters are transmitted for delay instead of a timed delay. This is useful for high 
baud rate terminals, that need only a minimal delay. If OFDEL is set, the fill character is DEL; otherwise 
NUL. 

If a form-feed or vertical-tab delay isspecified, it lastsfor about 2 seconds. 

New-line delay lasts about 0.10 seconds. If ONLRET is set, carriage-return delays are used instead of the 
new-line del ays. If OFILL is set, two fill characters are transmitted. 

Carriage-return delay type 1 depends on the current column position; type 2 is about 0.10 seconds; type 3 
about 0.15 seconds. If OFILL is set, delay type 1 transmitstwo fill characters; type 2, four fill characters. 

Florizontal-tab delay type 1 is depends on the current column position. Type 2 is about 0.10 seconds; type 3 
specifies that tabs are to be expanded into spaces. If OFILL is set, two fill characters are transmitted for 
any delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is set, one fill character is transmitted. 

The actual delays depend on line speed and system load. 
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The initial output control value is all bits clear. 

Control Modes 

The c_cflag field describes the hardware control of the terminal: 


CBAUD 

Baud rate: 

CSIZE 

Character size: 

BO 

Hang up 

CS5 

5 bits 

B50 

50 baud 

CS6 

6 bits 

B75 

75 baud 

CS7 

7 bits 

B110 

110 baud 

CS8 

8 bits 

B134 

134.5 baud 



B150 

150 baud 

CSTOPB 

Send two stop bits, else one. 

B200 

200 baud 

CREAD 

Enable receiver. 

B300 

300 baud 

PARENB 

Parity enable. 

B600 

600 baud 

PARODD 

Odd parity, else even. 

B900 

900 baud 

HUPCL 

Hang up on last close. 

B1200 

1200 baud 

CLOCAL 

Local line, else dial-up. 

B1800 

1800 baud 

LOBLK 

Reserved for use by shl(l). 

B2400 

2400 baud 



B3600 

3600 baud 



B4800 

4800 baud 



B7200 

7200 baud 



B9600 

9600 baud 



B19200 

19200 baud 



B38400 

38400 baud 



EXTA 

External A 



EXTB 

External B 




TheCBAUD bits specify the baud rate. The zero baud rate, BO, is used to hang up the connection. If BO is 
specified, the modem control lines (see modem(7)) cease to be asserted. Normally, thisdisconnectstheline. 
For any particular hardware, impossible speed changes are ignored. CBAUD is provided for use with the 
termio structure. When the termios structure is used, several routines are availablefor setting and 
getting the input and output baud rates (see termios Structure Related Functions). 

The CSIZE bits specify the character size in bits for both transmission and reception. This size does not 
include the parity bit, if any. If CSTOPB is set, two stop bits are used; otherwise one stop bit. For exam¬ 
ple, at 110 baud, many devices require two stop bits. 

If PARENB is set, parity generation is enabled (a parity bit is added to each output character). Further¬ 
more, parity detection is enabled (incoming characters are checked for the correct parity). If PARENB is 
set, PARODD specifies odd parity if set; otherwise even parity is used. If PARENB is clear, both parity 
generation and parity checking are disabled. 

If CREAD is set, the receiver is enabled. Otherwise no characters can be received. 

The specific effects of the HUPCL and CLOCAL bits depend on the mode and type of the modem control in 
effect. See modem(7) for the details. 

If HUPCL is set, the modem control lines for the port are lowered (disconnected) when the last process 
using the open port closes it or terminates. 

If CLOCAL is set, a connection does not depend on the state of the modem status lines. If CLOCAL is 
clear, the modem status lines are monitored. 

Under normal circumstances, a call to read() waits for a modem connection to complete. Flowever, if 
either the 0__NDELAY or the 0_NONBLOCK flags are set or CLOCAL is set, the open() returns 
immediately without waiting for the connection. If CLOCAL is set, see Modem Disconnect for the effects of 
read() and write () for those files for which the connection has not been established or has been lost. 

LOBLK is used by the shell layers facility (see shl (1)). The shell layers facility is not part of the general ter¬ 
minal interface, and the LOBLK bit is not examined by thegeneral terminal interface. 

The initial hardware control value after open is B300, CS8, CREAD, and HUPCL. 

Local Modes 

The c_lflag field is used to control terminal functions. 
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ISIG Enablesignals. 

ICANON Canonical input (eraseand kill processing). 

XCASE Canonical upper/lower presentation. 

ECHO Enable echo. 

ECHOE EchoERASE as correcti ng backspace sequence. 

ECHOK EchoNL after kill character. 

ECHONL EchONL. 

NOFLSH Disableflush after interrupt, quit, or suspend. 

TOSTOP Send sigttou for background output. 

ECHOCTL Echo control characters as “char, del as “?. 

ECHOPRT Echo erased character as character is erased. 

ECHOKE bssp BS erase entire I i ne on I i ne kill. 

FLUSHO Output is being flushed. 

PENDIN Reprocess pending input at next read or input character. 

IEXTEN Enable extended functions. 

If ISIG is set, each input character is checked against the special control characters intr, quit, SUSP, and 
dsusp (see Process Group Control IOCTL Commands). If an input character matches one of these control 
characters, the function associated with that character is performed and the character is discarded. If 
ISIG is clear, no checking is done and the character is treated as a normal data character. Thus these 
special input functions are possibleonly if ISIG is set. 

If ICANON is set, canonical processing is enabled. This enables the erase and kill edit functions, and the 
assembly of input characters into lines delimited by nl, eof, eol, or EOL2. If ICANON is clear, read 
requests are satisfied directly from the input queue. A read blocks until at least min characters have been 
received or the timeout valueTi M E has expired between characters. (See Non-Canonical Modelnput Pro¬ 
cessing (min/time Interaction)). This allows fast bursts of input to be read efficiently while still allowing 
single-character input. The time value represents tenths of seconds. 

If XCASE is set, and if ICANON is set, an uppercase letter is accepted on input by preceding it with a \ 
character, and is output preceded by a \ character. In this mode, the following escape sequences are gen¬ 
erated on output and accepted on input: 

To obtain: Use: 

V 

I \! 

{ \< 

) \) 

\ w 

For example, A is input as \a, \n as \\n, and \N as \\\n. XCASE would normally be used in con¬ 
junction with IUCLC and OLCUC for terminals that support only the first-sixty-four-character limited 
character set. In this case, IUCLC processing is done before XCASE for input, and processing is done 
after XCASE for output. Therefore typing A causes an a to be read because of IUCLC, and typing \A 
causes an A to be read since IUCLC produces \a which isturnedinto Abythe XCASE processing. 

If ECHO isset, characters are echoed back to the terminal when received. If ECHO isdear, characters are 
not echoed. 

When ICANON is set, canonical processing is enabled. This enables the erase and kill edit functions, and 
the assembly of input characters into lines delimited by nl, EOF, eol and EOL2 as described in Canonical 
Modelnput Processing. Furthermore, thefollowingechofunctionsarepossible. 

If ECHO and ECHOE are set, the erase and we rase characters are echoed as the three-character ascii 
sequence bs SP bs, which clears the last character or word from the CRT screen. 

If ECHO and ECHOPRT are set, and ECHOE isdear, thefirst erase andWERASE character in a sequence 
echoes a backslash (\) followed by the characters being erased. Subsequent erase or we rase characters 
echo the characters being erased in reverse order. The next non-erase character causes a slash (/) to be 
typed before it is echoed. 

If ECHOKE and ECHO are set, the kill character is echoed by erasing each character on the line from the 
CRT screen using using the method selected by ECHOE and ECHOPRT. 

If ECHOCTL and ECHO are set, all control characters (characters with codes between 0 and 37 octal) other 
than ascii tab, ascii nl, the start and STOP characters, ascii CR, and ascii bs are echoed as “char, 
where char is the character given by adding 100 octal to the control character's code. 
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If ECHOK is set and ECHOKE is not set, theNL character is echoed after the kill character to emphasize 
that the line is being deleted. 

If ECHONL is set, theNL character is echoed even if ECHO is clear. This is useful for terminals set to local 
echo (that is, half duplex). 

Unless escaped, the EOF character is not echoed. Because ascii EOT is the default EOF character, this 
prevents terminals that respond to EOT from hanging up. 

If NOFLSH is set, the normal flush of the input and output queues associated with quit, interrupt, and 
suspend characters is not done. However, NOFLSH does not affect the flushing of data upon receipt of a 
break when BRKINT is set. 

If the TOSTOP bit is set, an attempt by a process that is not in the foreground process group to write to its 
controlling terminal will be denied when the process is not ignoring and not blocking the SIGTTOU signal. 
If the write is denied and the process is a member of an orphaned process group write () returns -1 and 
sets errno to ElO and no signal is sent. If the write is denied and the process is a not a member of an 
orphaned process group, the SIGTTOU signal is sent to that process group. 

If FLUSHO is set, data written to the terminal device is discarded. This bit is set by a program. A pro¬ 
gram can cancel the FLUSHO effect by clearing FLUSHO. 

If PENDIN is set, any input that has not been read is reprocessed and possibly re-echoed when the next 
character arrives as input. 

If ICANON is set, the erase, kill, and EOF characters can be escaped by a preceding \ character, in 
which case no special function is done. 

IEXTEN must be set before the ECHOCTL, ECHOPRT, ECHOKE, FLUSHO, and PENDIN functions are 
allowed. In addition, the special characters we rase and lnext are allowed only if IEXTEN is set. 
IEXTEN does not affect any other functions. 

The initial local control value is all-bits-clear. 

Special Control Characters 

Special control characters are defined in the array c_cc. All of these special characters can be changed. 
The subscript name and description for each element in both canonical and non-canonical mode are shown 
in thefollowing table. 


Subscript Usage 

Canonical Non-Canonical Description 


VEOF 


EOF character 

VEOL 


eol character 

VEOL2 


EOL2 character 

VERASE 


erase character 

VWERASE 


we rase character 

VINTR 

VINTR 

intr character 

VKILL 


kill character 


VMIN 

min value 

VQUIT 

VQUIT 

quit character 

VSTART 

VSTART 

start character 

VSTOP 

VSTOP 

stop character 

VSUSP 

VSUSP 

SUSP character 

VDSUSP 

VDSUSP 

dsusp character 


VTIME 

time value 

VLNEXT 

VLNEXT 

lnext character 


termios Structure-Related Functions 

Thefollowing functions are provided when using the termios structure. Note that the effects on the termi¬ 
nal device of the cfsetispeed () and cfsetospeed () functions do not become effective until the 
tcsetattr () function is successfully called. Refer to the appropriate manual entries for details. 

termios Structure Functions 
Function Description 

cfgetospeed () get output baud rate 

cfgetispeed () get input baud rate 

cfsetospeed () set output baud rate 


HP-UX Release 11.0: October 1997 


-12- 


Section 7-171 


termio(7) 


termio(7) 


cfsetispeed() 
tcgetattr() 
tcsetattr () 


set input baud rate 
get terminal state 
set terminal state 


termio Structure-Related IOCTL Commands 

Several ioctl () system calls apply to terminal files that use the termio structure (see termio Struc¬ 
ture). If a requested command is not recognized, the request returns -1 with errno settoElNVAL. 

ioctl () system calls that reference the termio structure have the form: 

ioctl (fildes, command, arg) 

struct termio *arg; 

Commands using this form are: 

TCGETA Get the parameters associated with the terminal and store them in the termio 
structure referenced by arg. This command is allowed from a background process; 
however, the information may be subsequently changed by a foreground process. 

TCSETA Set the parameters associated with the terminal from the termio structure refer¬ 
enced by arg. The change is immediate. If characters are being output when the 
command is requested, results are undefined and the output may be garbled. 

TCSETAW Wait for the output to drain before setting new parameters. This form should be used 
when changing parameters that affect output. 

TCSETAF Wait for the output to drain, then flush the input queue and set the new parameters. 

termio Caveats 

Only the first eight special control characters (see termios Structure) can be set or returned. The values of 
indices veol and veof are the same as indices vtime andVMiN respectively. Hence if ICANON is set, 
veol or vtiME is the additional end-of-line character and veof or vmin is the end-of-file character. If 
ICANON is clear, veol or vtime is the inter-character-timer value and veof or vmin is the minimum 
number of characters desired for reads. 


Structure-Independent Functions 

The following functions which are independent of both the termio and termios structures are pro¬ 
vided for controlling terminals. Refer to the appropriate manual entries for details. 


Structure-1 ndependent Functions 

Function Description 


tcsendbreak() 
tcdrain() 
tcflush() 
tcflow() 
tcgetpgrp () 
tcsetpgrp() 
tcgetsid() 


send a break 

wait until output has drained 
flush input or output queue or both 
suspend or resume input or output 
get foreground process group id 
set foreground process group id 
get session id 


System Asynchronous I/O IOCTL Commands 

The following ioctl () system calls provide for system asynchronous I/O and have the form: 

ioctl (fildes, command, arg) 
int *arg; 

Commands using this form are: 

FIOSSAIOSTAT If the integer referenced by arg is non-zero, system asynchronous I/O is enabled; 

that is, enable SIGIO to be sent to the process currently designated with 
FIOSSAIOOWN (see below) whenever the terminal device file status changes 
from "no read data available!' to "read data available!'. If no process has been 
designated with FIOSSAIOOWN, enable SIGIO to be sent to the first process 
that opened the terminal device file. 

If the designated process has exited, the SIGIO signal is not sent to any pro¬ 
cess. 

If the integer referenced by arg isO, system asynchronous I/O is disabled. 
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The default on open of a terminal device file is that system asynchronous I/O is 
disabled. 

FIOGSAIOSTAT The integer referenced by arg is set to 1 if system asynchronous I/O is enabled. 
Otherwise, the integer referenced by arg is set to 0. 

FIOSSAIOOWN Set the process id that will receive the SIGIO signals due to system asynchro¬ 
nous I/O to the value of the integer referenced by arg. If no process can be found 
corresponding to that specified by the integer referenced by arg, the call returns 
-1 with errno set to esrch. A user with appropriate privileges can designate 
that any process receive the SIGIO signals. If the request is not made by a 
user with appropriate privileges and the cal ling process does not either designate 
that itself or another process whose real, saved, or effective user id matches its 
real or effective user id or the calling process does not designatea process that is 
a descendant of the calling process to receive the SIGIO signals, the call 
returns -1 with errno set to EPERM. 

If the designated process subsequently exits, the SIGIO signal is not sent to 
any process. 

The default on open of a terminal device file is that the process performing the 
first open is set to receive the SIGIO signals. 

FIOGSAIOOWN The integer referenced by arg is set to the process id designated to receive 
SIGIO signals. 


Line Control IOCTL Commands 

Several ioctlf) system calls control input and output. Some of these cal I shave the form: 

ioctl (fildes, command, arg) 

int arg; 

Commands using this form are: 

TCSBRK Wait for the output to drain. If arg is 0, send a break (zero bits for at least 0.25 
seconds). The tcsendbreak () function performs the same function (see 
tcsendbreak(3C)). 

TCXONC Start/stop control. If arg is 0, suspend output; if 1, restart suspended output; if 2, 
transmit a stop character; if 3, transmit a start character. If any other value is 
given for arg, the call returns -1 with errno set to EINVAL. Thetcflow() func¬ 
tion performs the same functions (see tcflow(3C)). 

TCFLSH If arg is 0, flush the input queue; if 1, flush theoutput queue; if 2, flush both the input 

and output queues. If any other value is given for arg, the call returns -1 with 
errno set to EINVAL. Thetcflush() function performs the same functions (see 
tcflush(3C)). 

Sending a break is accomplished by holding the data transmit lineat a space or logi¬ 
cal zero condition for at least 0.25 seconds. During this interval, data can be sent to 
the device, but because of serial data interface limitations, the break takes pre¬ 
cedence over all data. Thus, all data sent to a device during a break is lost. This 
includes system-generated xon/xoff characters used for input flow control. Note also 
that a delay in transmission of thexOFF flow control character until after the break 
is terminated could still result in data overflow because the flow control character may 
not be sent soon enough. 

Other calls have the form: 

ioctl (fildes, command, arg) 

int *arg; 

Commands using this form are: 

FIONREAD Returns in the integer referenced by arg the number of characters immediately read¬ 
able from the terminal device file. This command is allowed from a background pro¬ 
cess; however, the data itself cannot be read from a background process. 
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Non-blocking I/O IOCTL Commands 

Non-blocking I/O is easily provided via the 0_N0NBL0CK and 0_NDELAY flags available in both open(2) 
and fcntl(2). The commands in this section are provided for backward compatibility with previously 
developed applications, ioctl () system calls that provide a style of non-blocking I/O different from 
O NONBLOCK and 0_NDELAY have the form: 

ioctl (fildes, command, arg) 
int *arg; 

Commands using this form are: 

FIOSNBIO If the integer referenced by arg is non-zero, FlOSNBlO-style non-blocking I/O is 
enabled; that is, subsequent reads and writes to the terminal device file are handled in 
a non-blocking manner (see below). If the integer referenced by arg is 0, 
FlOSNBlO-style non-blocking I/O is disabled. 

For reads, FIOSNBIO-style non-blocking I/O prevents all read requests to that device 
file from blocking, whether the requests succeed or fail. Such a read request com¬ 
pletes in one of three ways: 

• If there is enough data availableto satisfy the entire request, the read com¬ 
pletes successfully, having read all of the data, and returns the number of 
characters read; 

• If there is not enough data availableto satisfy the entire request, the read 
completes successfully, having read as much data as possible, and returns the 
number of characters read; 

• If there is no data available, the read returns -1 with errno set to 
EWOULDBLOCK. 

For writes, FlOSNBlO-style non-blocking I/O prevents all write requests to that dev¬ 
ice file from blocking, whether the requests succeed or fail. Such a write request com¬ 
pletes in one of three ways: 

• If there is enough space available in the system to buffer all the data, the 
write completes successfully, having written out all of the data, and returns 
the number of characters written; 

• If there is not enough space in the buffer to write out the entire request, the 
write completes successfully, having written as much data as possible, and 
returns the number of characters written; 

• If there is no space in the buffer, the write returns -1 with errno set to 
EWOULDBLOCK. 

To prohibit FlOSNBlO-style non-blocking I/O from interfering with the 
O NONBLOCK and 0_NDELAY flags (see open(2) and fcntl (2)), the functionality of 
O NONBLOCK and 0_NDELAY always supersedes the functionality of FIOSNBIO- 
style non-blocking I/O. This means that if either 0_N0NBL0CK or 0_NDELAY is set, 
the driver performs read requests in accordance with the definition of O^NDELAY or 
O NONBLOCK. When both 0_N0NBL0CK and 0_NDELAY are dear, the definition 
of FlOSNBlO-style non-blocking I/O applies. 

The default on open of a terminal device file is that FlOSNBlO-style non-blocking 
I/O is disabled. 

FIOGSNBIO The integer referenced by arg is set to 1, if FlOSNBlO-style non-blocking I/O is 
enabled. Otherwise, the integer referenced by arg is set to 0. 

Process Group Control IOCTL Commands 

The process group control features described here (except for setting and getting the delayed stop process 
character) are easily implemented using the functions tcgetattr () , tcsetattr() , tcgetpgrpO , 
tcsetpgrpO , and tcsetsid() , (see tcattribute(3C), tcgetpgrp(3C), tcsetpgrp(3C), and tcgetsid(3C) 
respectively). 

The following structure, used with process group control, is defined in <bsdtty .h>: 

struct ltchars { 

unsigned char t_suspc; /* stop process character*/ 
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) ; 


unsigned char t_dsuspc; 
unsigned char t rprntc; 
unsigned char t_flushc; 
unsigned char t_werasc; 
unsigned char t lnextc; 


/* delayed stop process character*/ 

/* reserved; must be '_POSIX_VDISABLE'*/ 
/* reserved; must be ' __POSIX_VDISABLE' */ 
/* reserved; must be '_POSIX_VDISABLE'*/ 
/* reserved; must be '_POSIX_VDISABLE'*/ 


The initial value for all these characters is _P0SIX_VDISABLE, which causes them to be disabled. The 
meaning for each character is as follows: 

t_suspc Suspend the foreground process group. A suspend signal (SIGTSTP) is sent to all 
processes in the foreground process group. Normally, each process is forced to stop, 
but arrangements can be made to either ignore or block the signal, or to receive a trap 
to an agreed-upon location; see signal (2) and signal (5). When enabled, the typical 
value for this character is Control-Z or ascii sub. Setting or getting t_suspc is 
equivalent to setting or getting the SUSP special control character. 

t_dsuspc Same as t_suspc, except that the suspend signal (SIGTSTP) is sent when a process 
reads the character, rather than when the character is typed. When enabled, the typ¬ 
ical valuefor this character is Ctrl-Y or ascii EM. 


Attempts to set any of the reserved characters to a value other than _P0SIX_VDISABLE cause 

ioctl () to return -1 with errno set to einval with no change in value of the reserved character. 

ioctl () system calls that use the above structure have the form: 

ioctl (fildes, command, arg) 

struct ltchars *arg; 

Commands using this form are: 

TIOCGLTC Get the process group control characters and store them in the ltchars structure refer¬ 
enced by arg. This command is allowed from a background process. However, the 
information may be subsequently changed by a foreground process. 

TIOCSLTC Set the process group control characters from the structure referenced by arg. 

Additional process group control ioctl () system calls have the form: 

ioctl (fildes, command, arg) 

unsigned int *arg; 

Commands using this form are: 

TIOCGPGRP Returns in the integer referenced by arg the foreground process group associated with 
the terminal. This command is allowed from a background process. However, the 
information may be subsequently changed by a foreground process. This feature is 
easily implemented using the tcgetpgrp() function (see tcgetpgrp(3C)). 

If the ioctl () call fails, it returns -1 and sets errno to one of the following 
values: 

[ebadf] fildes is not a valid file descriptor. 

[enotty] The file associated with fildes is not the controlling terminal, or the 
calling process does not have a control ling terminal. 

[EACCES] The file associated with fildes is the controlling terminal of the cal¬ 
ling process, however, there is no foreground process group defined 
for the controlling terminal. 

Note: EACCES may not be returned in future releases. Behavior in 
cases where no foreground process group is defined for the control¬ 
ling terminal may change in future versions of the posix standard. 
Portable applications, therefore, should not rely on this error condi¬ 
tion. 

TIOCSPGRP Sets the foreground process group associated with the terminal to the value refer¬ 
enced by arg. This feature is easily implemented using the tcsetpgrpO function 
(seetcsetpgrp(3C)). 
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TIOCGSID 


TIOCLGET 

TIOCLSET 

TIOCLBIS 

TIOCLBIC 


If the ioctl() call fails, it returns -1 and sets errno to one of the following 
values: 

[ebadf] fildes is not a valid file descriptor. 

[einval] The process id referenced by arg is not a supported value. 

[enotty] The calling process does not have a controlling terminal, or the 

fildes is not the controlling terminal, or the controlling terminal is 
no longer associated with the session of the cal ling process. 

[eperm] The process id referenced by arg is a supported value but does not 
match the process group id of a process in the same session as the 
calling process. 

Returns in the integer referenced by arg the session ID of the terminal specified by 
fildes. This feature is easily implemented using the tcgetsid() function (see 
tcgetsid(3C)). 

If the ioctl() call fails, it returns -1 and sets errno to one of the following 
values: 

[ebadf] fildes is not a valid file descriptor. 

[enotty] The device associated with fildes is not a terminal. 

[EACCES] The fildes is a terminal that is not allocated to a session. 

Get the process group control mode word and store it in the int referenced by arg. 
This command is allowed from a background process; however, the information may 
be subsequently changed by a foreground process. 

Set the process group control mode word to the value of the int referenced by arg. 

Use the int referenced by arg as a mask of bits to set in the process group control 
mode word. 

Use the int referenced by arg as a mask of bits to clear in the process group control 
mode word. 


The following bit is defined in the process group control mode word: 

LTOSTOP Send SIGTTOU for background writes. 

Setting or clearing LTOSTOP is equivalent to setting or clearing the TOSTOP flag (see Local Modes). If 
LTOSTOP is set and a process is not in the foreground process group of its controlling terminal, a write by 
the process to its controlling terminal may be denied (seeTerminal Access Control). 


Terminal SizeiOCTL Commands 

The following ioctl () system calls are used to get and set terminal size information for the terminal 
referenced by fildes. These ioctl () system calls use the winsize structure to get and set the termi¬ 
nal size information. The winsize structure, defined in <termios.h>, has thefollowing members : 


unsigned short ws_row; 
unsigned short ws_col; 
unsigned short ws xpixel; 
unsigned short ws ypixel; 


/* Rows, in characters */ 

/* Columns, in characters */ 

/* Horizontal size, in pixels */ 
/* Vertical size, in pixels */ 


The initial values for all elements of terminal size are zero. The values for terminal size are neither set nor 
used by the general terminal interface, and have no effect on thefunctionality of the general terminal inter¬ 
face. The values for terminal size are set and used only by applications that access them through the 
terminal-size ioctl () system calls (see ioctl (2)). 


ioctl () system calls that use the above structure have the form: 


ioctl (fildes, command, arg) 
struct winsize *arg; 

Commands using this form are: 

TIOCGWINSZ Get the terminal size values and store them in the winsize structure referenced by 
arg. This command is allowed from a background process. 
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TIOCSWINSZ Set the terminal size valuesfrom thewinsize structure referenced by arg. If any of 
the new values differ from previous values, a SIGWINCH signal is sent to all 
processes in the terminal's foreground process group. 

Console Output Redirection IOCTL Command 

Output which would normally be sent to the system console may be redirected to any other TTY device or 
pseudo-device in the system. The ioctl () system call used to control console output redirection has the 
form: 


ioctl (fildes, command, arg) 
int arg; 

The command using this form is: 

TIOCCONS Redirect system console output. Any output that would normally be sent to the sys¬ 
tem console, either through kernel printf requests, or through the console special file, 
will instead be sent to the terminal referenced by fildes. The value of arg is ignored. 
The user must have superuser privileges to execute this request. Otherwise, the call 
returns -1 with errno settoEPERM. If the console output has not been redirected 
to a different device by a later call to this command, it is redirected back to the physi¬ 
cal console device when fildes is closed. 


WARNINGS 

Various hp-ux implementations use non-serial interfaces that look like terminals (such as bit-mapped 
graphics displays) or "smart cards" that cannot implement the exact capabilities described above. There¬ 
fore, not all systems can exactly meet the standard stated above. Each implementation is required to state 
any deviations from the standard as part of its system-specific documentation. 


FIOSSAIOSTAT 

FIOGSAIOSTAT 

FIOSSAIOOWN 

FIOGSAIOOWN 

FIOSNBIO 

FIOGNBIO 


is similar to BSD 4.2 FIOASYNC, with the addition of provisions for security. 

is of HP origin, complements FIOSSAIOSTAT, and allows saving and restoring 
system asynchronous I/O tty states for command interpreter processes. 

is similar to BSD 4.2 FIOSETOWN, with additional provisions for security. 

is similar to BSD FIOGETOWN. 4.2 Note also the difference that the BSD 4.2 ver¬ 
sion of this functionality used process groups, while the hp-ux version only uses 
processes. 

is the same as BSD fionbio, 4.2 except that it does not interfere with the 
0_NDELAY or ONONBLOCK open() and fcntl() flags. 

is of HP origin, complements FIOSNBIO, and allows saving and restoring the 
FlOSNBlO-stylenon-blockingi/OTTY state for command interpreter processes. 


The general terminal interface uses a system resource known as a cblock to store data being transmitted 
or received through a communications port. These cblocks are continuously used and freed for reuse as 
data pass through the system. I f too few cblocks are configured i n the system, the cblock pool may be tem- 
porarily or permanently exhausted, and data loss, system hangs, or reduced system performance can 
result. 


If cblock exhaustion is suspected, you can examine the system message buffer with dmesg (see dmesg(lM)) 
for messages indicating cblock exhaustion has occurred. Or, you can use adb (see adb(l)) if examining the 
corefile of a dump. The message format is 

WARNING: cblock exhaustion occurred n times 


where n indicates the number of times the operating system has requested a cblock and none could be pro¬ 
vided. If this message is observed, the kernel should be reconfigured to generate a larger number of 
cblocks. 


A cblock is 32 bytes in length. The default number of cblocks configured in the system is computed from 
the tunable system parameter maxusers , and is defined to be 

100+16*maxusers 


This can be overridden by using the optional tunable system parameter nclist to specify the desired 
number of cblocks to be used in the system. 

SAM or config(lM) may be used to generate a new kernel with a new nclist value. 
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DEPENDENCIES 
Series 700 

Built-in serial ports on Series 700 machines support the foil owing additional baud rate settings: 57600, and 
115200. An RS-232-to-RS-422 converter may be required to achieve practical cable lengths at these baud 
rates (because RS-232 only specifies up to 19200 baud). 

Timed delays are not supported. 

Built-in serial ports on Series 700 systems have RTS and CTS flow control capability, configurable receive 
FIFO trigger levels, and a configurable transmit limit. RTS/CTS hardware handshaking can be enabled 
through a bit in the device file minor number, through an ioctl() call (see termiox(7)), or through the 
stty command (see stty(l)). 

The receive FIFO trigger level is configurable through two bits in the device file minor number. The receive 
FIFO trigger level is used to set the level at which a receive interrupt is generated to the system. Settinga 
smaller value for the receive FIFO trigger level enables the system to react more quickly to receipt of char¬ 
acters. However, using a smaller trigger level increases system overhead to process the additional inter¬ 
rupts. A higher receive FIFO trigger level reduces the system interrupt overhead for heavy inbound data 
traffic at the cost of less time for the system to read data from the hardware before receive FIFOs are over¬ 
run. When using RTS flow control, the receive FIFO trigger level also determines the point at which the 
hardware lowers RTS to protect the receive FIFO. Use of a higher receive FIFO trigger level also reduces 
xoff flow control responsiveness because, under light inbound data flow conditions, receipt of thexoFF 
character by the system is slightly delayed. Choice of the appropriate receive FIFO trigger level should be 
based upon how the serial port isto be used. For most applications a receiveFlFO trigger level of 8 (c3,c2 = 
10) is suggested. 

Two bits in the device file minor number specify the transmit limit, the number of characters which are suc¬ 
cessively loaded into the transmit FIFO. Setting a smaller transmit limit allows the transmitter to be more 
responsive to flow control either from receipt of an XOFF character or de-assertion of CTS at the cost of 
increased system interrupt overhead. Setting a larger transmit limit reduces interrupt overhead but is not 
as responsive to flow control since the remainder of the transmit FIFO can be transmitted even after the 
transmitter is flow controlled. When communicating with devices which have little tolerance for data 
receipt after flow control, one must choose the transmit limit appropriately. 

Device file minor number 

Series 700 devicefile minor numbers taketheform: 

0x11C OHM 
where: 


II = Two hexadecimal digits (8 bits) to indicatetheinstanceof theserial interface. 

C = One hexadecimal digit (4 bits) for FIFO control. Values for each bit are as follows: 


Receive FIFO Trigger Level 

Transmit Limit | 

C 3 

C 2 

Level 

c i 

c o 

Limit 

0 

0 

1 

0 

0 

1 

0 

1 

4 

0 

1 

4 

1 

0 

8 

1 

0 

8 

1 

1 

14 

1 

1 

12 


H = One hexadecimal digit (4 bits) which controls diagnostic access and hardwareflow control. 


Bit 

Value 

h 3 

n 3 

h o 

Diagnostic telephony access 

Reserved 

Reserved 

Enables RTS/CTS hardwareflow control 


M = One hexadecimal digit (4 bits) to determine the port access type. Values for each bit are as 
follows: 
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Bit 

Value 

m 3 

m 2 

m i m o 

TI/ALP 

0 = Simple protocol (U.S.), 

I = CCITT protocol (Europe) 

00 = Direct 

01 = Dial-out modem 

10 = Dial-in modem 

II =1 nvalid 


Series 800 

Timed output delays are not directly supported. If used, an appropriate number of fill characters (based on 
the current baud rate) is output. The total time to output the fill characters is at least as long as the time 
requested. 

The system specified input flow control values are as follows: low water mark is 60, high water mark is 
180, and maximum allowed input is 512. 

TheHP 98196A (formerly 27140A option 800) i nterface does not support thefollowing hardware settings: 

CBAUD B200,B38400,EXTA, EXTB. 

The HP A1703-60003 and the HP 28639-60001 interfaces do not support baud rates above 9600. Further¬ 
more, changing the following hardware settings on port 0 from the default (9600 baud, 8 bit characters, 1 
stop bit, no parity) is not supported: 

CBAUD,CSIZE,CSTOPB, PARENB, PARODD. 

TheHP J 2094A interface does not support baud rates above 19200. 

The HP J 2094A supports RTS and CTS flow control. The RTS/CTS hardware handshaking can be enabled 
through a bit in the device file minor number, through an ioctl () call (see termiox(7)), or through the 
stty command (see stty(l)). 

Device file minor number 

Series 800 device file minor numbers take the form: 

OxlIPPHM 

where: 


II = Two hexadecimal digits (8 bits) to indicatetheinstanceof theserial interface. 

PP = Two hexadecimal digits (8 bits) to indicatethe port number of this device on the serial inter¬ 
face. 

FI = One hexadecimal digit (4 bits) which controls diagnostic access and hardware flow control (FH P 
J 2094A only). 


Bit 

Value 

h 3 

n 3 

h o 

Card diagnostic 

Port diagnostic 

Reserved 

Enables RTS/CTS hardware flow control 


M = One hexadecimal digit (4 bits) for the port access type. Values for each bit are as follows: 


Bit 

Value 

m 3 

m 2 

m i m o 

TI/ALP 

0 = Simple protocol (U.S.), 

1= CCITT protocol (Europe) 

00 = Direct 

01 = Dial -out modem 

10 = Dial-in modem 

11 = Invalid 
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AUTHOR 

termios was developed HP and the IEEE Computer Society. 

termio was developed by HP, AT&T, and the U niversity of California, Berkeley. 

FILES 

/dev/console 
/dev/cua * 

/dev/cul* 

/dev/tty * 

/dev/ttyd* 

EISA mux has adopted thefollowing device files naming convention: 

/dev/<cua | cul | tty | ttydxl nstance_Number><Port_Module_Name><Port_Number> 
where Port_Module_Name = [a..h], Port_Number =1-16 

For example: /dev/cua2al, /dev/cul2b8 , /dev/tty2gl2 , /dev/ttyd2hl6 

SEE ALSO 

adb(l), shl(l), stty(l), config(lM), dmesg(lM), mknod(lM), fork(2), ioctl(2), setsid(2), signal(2), stty(2), 
setpgid(2), blmode(3C), cfspeed(3C), tccontrol(3C), tcattribute(3C), tcgetpgrp(3C), tcsetpgrp(3C), 
tcgetsid(3C), signal(5), unistd(5), sttyV6(7), tty(7), modem(7), termiox(7). 

STANDARDS CONFORMANCE 

termio: SVID2, SVID3, XPG2 

termios: AES, SVID3, XPG3, XPG4, FIPS 151-2, POSIX.1 
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NAME 

termiox - extended general terminal interface 

SYNOPSIS 

include <sys/termiox.h> 

ioctl (int tildes, int request, struct termiox * arg) 


DESCRIPTION 

The extended general terminal interface supplements the termio(7) general terminal interface by adding 
support for asynchronous hardware flow control and local implementations of additional asynchronous 
features. Some systems may not support all of these capabilities because of hardware or software limita¬ 
tions. Other systems may not permit certain functions to be disabled. I n such cases, the appropriate bits 
areignored. If thecapabilitiescan be supported, the interface described here must be used. 

Hardware Flow Control Modes 

Hardware flow control supplements the termio IXON, IXOFF, and IXANY character flow control (see ter - 
mio(7)). Character flow control occurs when one device controls the data transfer of another device by 
inserting control characters in the data stream between devices. Hardware flow control occurs when one 
device controls the data transfer of another device by using electrical control signals on wires (circuits) of 
the asynchronous interface. Character flow control and hardware flow control can be simultaneously set. 

In asynchronous, full duplex applications, the use of the Electronics Industries Association's eia-232-d 
Request To Send (RTS) and Clear To Send (CTS) circuits is the preferred method of hardware flow control. 

The Ei A-232-D standard specified only unidirectional hardware flow control where the Data Circuit¬ 
terminating Equipment or Data Communications Equipment (DCE) indicates to the Data Terminal Equip¬ 
ment (DTE) to stop transmitting data. The termiox interface allows both unidirectional and bidirectional 
hardware flow control; when bidirectional flow control is enabled, either the DCE or DTE can indicate to 
each other to stop transmitting data across the interface. 

Clock Modes 

Isochronous flow control and clock mode communication are not supported. 


Terminal Parameters 

Parameters that control the behavior of devices providing the termiox interface are specified by the ter¬ 
miox structure, defined in the <sys/termiox.h> header file. Several ioctl () system calls (see 
ioctl (5)) that fetch or change these parameters use the termiox structure which contains the following 
members: 


unsigned short x_hflag; 
unsigned short x_cflag; 
unsigned short x_rflag; 
unsigned short x_sflag; 


/* hardware flow control modes */ 
/* clock modes */ 

/* reserved modes */ 

/* spare local modes */ 


The x_hflag field describes hardware flow control modes: 


RTSXOFF 0000001 EnableRTS hardwareflow control on input. 

CTSXON 0000002 EnableCTS hardwareflow control on input. 


The RTS and CTS circuits are involved in establishing CCITT modem connections. Since RTS and CTS circuits 
are used both by CCITT modem connections and by hardwareflow control, CCITT modem and hardwareflow 
control cannot be simultaneously enabled. 


Variations of different hardwareflow control methods can be selected by setting the appropriate bits. For 
example, bidirectional RTS/CTS flow control is selected by setting both the rtsxoff and CTSXON bits. Uni¬ 
directional CTS hardwareflow control is selected by setting only theCTSXON bit. 


If rtsxoff is set, the Request to Send (RTS) circuit (line) is raised, and if the asynchronous port needs to 
have its input stopped, it lowers the Request to Send (RTS) line. If the RTS line is lowered, it is assumed 
that the connected device will stop its output until RTS is raised. 


If CTSXON is set, output occurs only if the Clear To Send (CTS) circuit (line) is raised by the connected dev¬ 
ice. If theCTS line is lowered by the connected device, output is suspended until CTS is raised. 
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termiox Structure Related IOCTL Command 

The ioctl() system calls that reference the termiox structure have the form: 

ioctl (fildes, command, arg) 

struct termiox *arg; 

Commands using this form are: 

TCGETX The argument is a pointer to a termiox structure. The current terminal parame¬ 
ters are fetched and stored into that structure. 

TCSETX The argument is a pointer to a termiox structure. The current terminal parame¬ 
ters are set from the values stored in that structure. The change is immediate. 
Errors that can be returned include: 

[einval] The port does not support hardware flow control. 

[enotty] The file descriptor for this port is configured for CCITT mode access. 

Hardware flow control is not allowed on CCITT mode devices. 

TCSETXW The argument is a pointer to a termiox structure. The current terminal parame¬ 
ters are set from the values stored in that structure. The change occurs after all char¬ 
acters queued for output have been transmitted. This form should be used when 
changing parameters that affect output. Errors that can be returned include: 

[einval] The port does not support hardware flow control. 

[enotty] The file descriptor for this port is configured for CCITT mode access. 

Hardware flow control is not allowed on CCITT mode devices. 


TCSETXF The argument is a pointer to a termiox structure. The current terminal parame¬ 
ters are set from the values stored in that structure. The change occurs after all char¬ 
acters queued for output have been transmitted; all characters queued for input are 
discarded, then the change occurs. Errors that can be returned include: 

[einval] The port does not support hardware flow control. 

[enotty] The file descriptor for this port is configured for CCITT mode access. 

Hardware flow control is not allowed on CCITT mode devices. 


AUTHOR 

termiox was developed by HP and AT&T. 

FILES 

Files in or under /dev/tty* . 

SEE ALSO 

ioctl(2), termio(7), modem(7). 
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NAME 

timod - STREAMS module for converting i octl () calls into Transport I nterface messages 


DESCRIPTION 

The timod module is a STREAMS modulethat converts ioctl () callsfrom a transport user supporting 
the Transport Interface (Tl) into messages that a transport protocol provider supporting Tl can consume. 
This allows the user to initiate certain Tl functions as atomic operations. This release of HP-UX no longer 
automatically pushes timod whenever a t_open(3) is performed. TheTLI and XTI libraries have been 
modified to no longer require this moduleto perform the atomic operations described within this man page. 
Binary compatibility is not a problem since the module will still exist within the kernel. But, any applica¬ 
tion which is recompiled and expects the module to be automatically pushed, may not work without code 
modification. 


The user places and removes the timod module on a device stream by calling the STREAMS I_PUSH 
ioctl() and I_POP ioctl () functions. (TheTLI function t_open () pushes timod onto the device 
stream for the user.) The timod module should only be pushed onto streams which are terminated by 
transport providers which conform to the Transport Interface. tirdwr(7) is an alternative interface to 
timod which supports the read() and write () system calls. If tirdwr has been pushed onto the 
stream, the user should use the l_POP ioctl to remove the tirdwr module from the stream before 
pushing timod. 

The timod module transparently passes any STREAMS messages that are not generated by the 
ioctl () commands described below to the neighboring module or driver, timod will act on an I_STR 
ioctl () whose strioctl. ic_cmd field is one of the values below. (See streamio(7) for a description 
of the I_STR ioctl and the strioctl structure.) 


TI_BIND ThisTI command binds an address to the transport protocol provider. The STREAMS mes¬ 
sage that the module issues to the TI_BIND ioctl () call is equivalent to theTI mes¬ 
sage type T_bind_req . The STREAMS message that the module returns in response to 
the successful completion of the TI_BIND ioctl () call is equivalent to theTI message 
type T_bind_ack. 

TI_UNBIND ThisTI command unbinds an address from the transport protocol provider. TheSTREAMS 
message that the module issues to the TI_UNBIND ioctl () call is equivalent to theTI 
message type T_unbind_req . The STREAMS message that the module returns in 
response to the successful completion of the TI_UNBIND ioctl () call is equivalent to 
theTI message type T_ok_ack. 

TI_GETINF0 ThisTI command gets the Tl protocol-specific information from the transport protocol pro¬ 
vider. The STREAMS message that the module issues to the Tl_GETlNFO ioctl() call 
is equivalent to the Tl message type T_info_req. The STREAMS message that the 
module returns in response to the successful completion of the Tl_GETlNFO ioctl () 
call is equivalent to theTI message type T_info_ack. 


Tl_OPTMGMT ThisTI command gets, sets, or negotiates Tl protocol-specific options with the transport 
protocol provider. The STREAMS message that the module issues to the Tl_OPTMGMT 
ioctl () call is equivalent to the Tl message type T_optmgmt_req. TheSTREAMS 
message that the module returns in response to the successful completion of the 
TI_OPTMGMT ioctl () call is equivalent to theTI message type T_optmgmt_ack. 


RETURN VALUES 

If the timod module returns an error for an ioctl () call, the lower 8 bits of the return value will be one 
of theTI error codes defined in the <tiuser .h> header file. I f the Tl error is of the typeTSYERR, then 
the second 8 bits of the return value will contain an error as defined in the <errno.h> header file. The 
STREAMS message that the module issues when an ioctl() call results in an error is equivalent to the 
Tl message type T_error_ack. 

FILES 

<xti . h> defines the error codes for XTI functions. 

<tiuser. h> defines the error codes for Tl functions. 

<tihdr.h> defines the message types for Tl functions. 

<errno . h> defines the error codes for system errors. 
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SEE ALSO 

ioctl(2), t_open(3) : streamio(7) : tirdwr(7). 
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NAME 

tirdwr - STREAMS modulefor reads and writes by Transport I nterface users 

DESCRIPTION 

The tirdwr module is a STREAMS module that provides a transport user supporting the Transport I nter¬ 
face (Tl) with an alternate interface to a transport protocol provider supportingTI. This alternate interface 
allows the transport user to communicate with the transport protocol provider using the read() and 
write () functions. It can also conti nue to use the putmsg () andgetmsgO functions, but these func¬ 
tions will only transfer data messages between the user process and device stream. getpmsg() and 
putpmsg () should not be used with tirdwr. 

The user places the tirdwr module on a device stream by calling the STREAMS I_PUSH ioctl () 
function, tirdwr is an alternative interface to timod(7). If timod has been pushed onto the stream, the 
user should use the l_POP ioctl to remove the timod module from the stream before pushing 
tirdwr. The tirdwr module should only be pushed onto streams which are terminated by transport 
providers which conform to the Transport Interface. Once the module has been pushed on the device 
stream the user cannot make further calls to Tl functions. If the user attempts to do this, an error occurs 
on the stream. After the error is detected, subsequent calls fail with errno set to [EPROTO], The user 
removes the tirdwr modulefrom a devicestream by callingtheSTREAMS l_POP ioctl() function. 

Module Behavior When Pushed and Popped 

When the tirdwr module is pushed on a device stream, it checks any existing messages that are destined 
for the user to determine their message type. If existing messages are regular data messages, it forwards 
the messages to the user. It ignores any messages related to process management, such as messages that 
generate signals to the user. If any other messages are present, it returns an error to the user request 
with errno set to [EPROTO], 

When the tirdwr module is popped from a device stream, it checks whether an orderly release indication 
has been previously received from the transport protocol provider. If an orderly release indication was 
received, it sends an orderly release request to the remote side of the transport connection. The tirdwr 
module also acts this way when the device stream is closed. 

Module Behavior for Reads and Writes 

When the tirdwr module receives messages from the transport protocol provider that do not contain a 
control part (seethe putmsg(2) and getmsg(2) reference pages), it transparently passes the messages to its 
upstream neighbor. The exception is for zero-length data messages, where the module frees the message 
and does not pass them to its upstream neighbor. 

When the module receives messages from the transport protocol provider that contain a control part, it 
takes one of the foil owing actions: 

For data messages with a control part, it removes this part, then passes the message to its upstream 
neighbor. 

For messages that represent expedited data, it generates an error. Further system calls will fail with 
errno set to [EPROTO], 

For messages that represent an orderly release indication from the transport protocol provider, it gen¬ 
erates a zero-length data message, indicating the End-of-File(EOF), and sends this message upstream 
to the reading process. The original message containing the orderly release indication is freed. 

For messages that represent an abortive disconnect indication from the transport protocol provider, it 
causes all further write() and putmsgO calls to fail with errno set to [ENXIO], Subsequent 
read() and getmsgO calls will return zero-length data messages indicating the End-of-File 
(EOF), once all previous data has been read. 

For all other messages, it generates an error, and further calls will fail with errno set to [EPROTO], 

SEE ALSO 

getmsg(2), putmsg(2), read(2), write(2), t_open(3), streamio(7), timod(7). 
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NAME 

tty - controlling terminal interface 

DESCRIPTION 

The file /dev/tty is, in each process, a synonym for the control terminal associated with the process 
group of that process, if any. It is useful for programs or shell sequences that need to be sure of writing 
messages on the terminal no matter how output has been redirected. It can also be used for programs that 
demand the name of a file for output, when typed output is desired and it is tiresome to find out what ter¬ 
minal is currently in use. 

FILES 

/dev/tty 
/dev/tty * 

SEE ALSO 

termio(7). 

STANDARDS CONFORMANCE 

tty: AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1 
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NAME 

U DP -1 nternet U ser Datagram Protocol 

SYNOPSIS 

#include <sys/types.h> 

#include <sys/socket.h> 

#include <netinet/in.h> 

s = socket(AF_INET, SOCK„DGRAM, 0); 

DESCRIPTION 

UDP isasimple, unreliabledatagram protocol used to support theSOCK_DGRAM socket type for the inter¬ 
net protocol family. UDP sockets are connectionless, and are normally used with the sendto() and 
recvfromt) calls (see send(2) and recv(2). Theconnect() call can also be used to simulate a connec¬ 
tion (see connect(2). When used in this manner, it fixes the destination for future transmitted packets (in 
which case the send() or write () system calls can be used), as well as designating the source from 
which packets are received. The recv() andread() calls can be used at any time if the source of the 
message is unimportant. 

UDP address formats are identical to those used by TCP. In particular, UDP requires a port identifier in 
addition to the normal I nternet address format. Note that the UDP port domain is separate from the TCP 
port domain (in other words, a UDP port cannot be connected to a TCP port). 

The maximum message size for a UDP datagram socket is limited by the lesser of the maximum size of an 
IP datagram and the size of the UDP datagram socket buffer. The send and receive buffers for UDP sock¬ 
ets can be altered to a maximum value of 262142 bytes by using the SO_SNDBUF and SO_RCVBUF options 
of the setsockopt () system call. However, the maximum size of an IP datagram limitsthe maximum 
message size of a UDP message to 65507 bytes. Therefore, using the maximum socket buffer size will allow 
multiple maximum-sized messages to be placed on the send queue. The default inbound and outbound mes¬ 
sage size limit for a UDP datagram socket is 65535 bytes. The maximum message size for a UDP broadcast 
is limited by the MTU size of the underlying link. 

ERRORS 

One of the following errors may be returned in errno if a socket operation fails. For a more detailed list 
of errors, see the man pages for specific system calls. 

[EISCONN] Attempt to send a datagram with the destination address specified, when the 

socket is already connected. 

[ENOBUFS] No buffer space is availablefor an internal data structure. 

[EADDRINUSE] Attempt to create a socket with a port which has already been allocated. 

[EADDRNOTAVAIL] Attempt to create a socket with a network address for which no network inter¬ 
face exists. 


AUTHOR 

The socket i nterfaces to u D p were developed by theUniversity of California, Berkeley. 

SEE ALSO 

ndd(lM). getsockopt(2), recv(2), send(2), socket(2), t_open(3), inet(7F), socket(7), 

RFC 768 User Datagram Protocol 

RFC 1122 Requirements for Internet hosts 
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NAME 

UNIX - local communication domain protocol 

SYNOPSIS 

#include <sys/types.h> 

#include <sys/un.h> 

DESCRIPTION 

The local communication domain protocol, commonly referred to in the industry as the Unix domain pro¬ 
tocol, utilizes the path name address format and the AF__UNIX address family. This protocol can be used 
as an alternative to the I nternet protocol family (TCP/I P or U DP/I P) for communication between processes 
executing on the same node. It has a significant throughput advantage when compared with local IP loop- 
back, due primarily to its much lower code execution overhead. Data is looped back at the protocol layer 
(OSI Level 4), rather than at the driver layer (OSI Level 2). 

Only SOCK_STREAM is supported in theAF_UNlX address family. 

The HP-UX implementation of the local communication domain protocol does not support the MSG_OOB 
flaginrecv() (see recv(2)) and send () (see send (2)). 

Addressing 

AF UNIX socket addresses are path names. They are limited to 92 bytes in length, including a terminat¬ 
ing null byte. Calls to bind() to an AF__UNIX socket utilize an addressing structure called 
struct sockaddr_un (see bind(2)). Pointers to this structure should be used in all AF__UNIX socket sys¬ 
tem calls wherever they requirea pointer to a struct sockaddr. 

The include file <sys/un.h> defines this addressing structure. Within this structure are two notable 
fields. The first is sun_family, which must be set to AF_UNIX. The next is sun_path, which is the null- 
terminated character string that specifies the path name of the file associated with the socket (for example, 
/tmp/my socket). 

Only the passive (listening) socket must bind to an address. The active socket connects to that address, but 
it does not need an address of its own. 

For additional information on using AF_UNIX sockets for interprocess communication, refer to the BSD 
Sockets I nterface Programmer's Guide. 

Socket Buffer Size 

For stream and datagram sockets, the maximum send and receive buffer size is 262142 bytes. The default 
buffer size is 32768 bytes. The send and receive buffer sizes can be altered by using the SO„SNDBUF and 
SORCVBUF options of the setsockopt () system call. Refer to getsockopt(2) for details. 

AUTHOR 

AFUNIX was developed by the University of California, Berkeley. 

SEE ALSO 

getsockopt(2), socket(2). 
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NAME 

vxfsio - VxFS-file-system control functions 

SYNOPSIS 

#include <sys/types.h> 

#include <sys/fs/vx_ioctl.h> 

int ioctl(int fildes, int cmd, ... /* arg */) ; 

DESCRIPTION 

The vxfs ioctl (2) enhancements provide for extended control over open files. 

The argument fildes is an open file descriptor. 

The data type and value of arg vary with the type of command indicated by cmd. Unless specified, arg 
is treated as an int type. The symbolic names for commands and file status flags are defined by the 
sys/f s/vx_ioctl. h header file. 

The enhancements availableare: 

VXSETCACHE 

Set caching advisories. These advisories allow an application to indicate to the file system which 
forms of caching would be most advantageous. 

NOTE: VX_SETCACHE is available with the VxFS Advanced package only. 

The values for arg are such that multiple advisories may be set by combining values with bitwise OR 
operations. The possible values for arg are 

VX_RANDOM 

I ndicates that the file is being accessed randomly. Read-ahead should not be performed. 
VXSEQ 

I ndicates that the file is being accessed sequentially. Maximum read-ahead should be per¬ 
formed. 

VX DIRECT 

I ndicates that data associated with read and write operations is to be transferred directly to 
or from the user supplied buffer, without being cached. When this options is enabled, all 
I/O operations must begin on block boundaries and must be a multiple of the block size in 
length. The buffer supplied with the I/O operations must be aligned to a page boundary. 

If an I/O request fails to meet alignment criteria, or the file is currently being accessed for 
mapped I/O, the I/O request will be performed as a data synchronous I/O operation. 

VXNOREUSE 

Indicates that buffered data does not need to be retained in anticipation of further use by 
the application. 

VXDSYNC 

Indicates that data synchronous I/O mode is desired. In data synchronous I/O mode, a 
write operation returns to the caller after the data has been transferred to external media, 
but the inode is not updated synchronously if only the times in the inode need to be 
updated. 

Only one of VX_RANDOM, VX_SEQ, or VX_DIRECT may be specified. The VX_NOREUSE and 
VX DSYNC options may not be used in conjunction with VX_DIRECT . The caching advisories for a 
file are maintained on a per-file basis. Changes made to the advisories by a process affect I/O opera¬ 
tions by all processes currently accessing the file. 

The VX SETCACHE ioctl returns a 0 if the caching advisories are successfully set. If the operation 
fails, the return value is -1 and the external variable errno will be a general DIAGNOSTIC. 

VXGETCACHE 

Get caching advisories in effect for thefile. Theargument arg should bea pointer to an int. 

The VX_GETCACHE ioctl returns a 0 if the caching advisories are successfully obtained and the 
advisories are returned in arg. If the operation fails, the return value is -1 and the external variable 
errno will be a general DIAGNOSTIC. 
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VXSETEXT 

Set extent information. 

NOTE: VX_SETEXT is availablewith the VxFS Advanced packageonly. 

The extent information is set according to the parameters specified by arg. The argument arg points to 
a structure of type vx_ext defined in sys/f s/vx_ioctl. h, which containsthefollowing members: 

off_t ext_size; /* extent size in fs blocks */ 

off_t reserve; /* space reservation in fs blocks */ 

int a_flags; /* allocation flags */ 

The ext_size element is used to request a fixed extent size, in filesystem blocks, for the file. If a 
fixed extent size is not required, zero should be used to allow the default allocation policy to be used. 
Changes to the fixed extent size made after the file contains indirect blocks have no effect unless all 
current indirect blocks are freed via file truncation and/or reservation deallocation. 

The reserve element is used to set the amount of space, in file system blocks, preallocated to the 
file. If the reserve amount is greater than the current reservation, the allocation for the file is 
increased to match the reserve amount. If the reserve amount is less than the current reser¬ 
vation, the allocation is decreased. The allocation will not be reduced to less than the current file size. 

File reservation cannot be increased beyond the ulimit(2) of the requesting process. Flowever, an 
existing reservation will not be trimmed to the requesting process's ulimit(2). Reservation of space for 
existing sparse files will not cause blocks to be allocated to fill in the holes, but will only allocate blocks 
after the end of the file. Thus, it's possible to have a larger reservation for a file than blocks in the 
file. 

The reservation amount is independent of file size since reservation is used to preallocate space for a 
file. 

The a_flags element is used to indicatethetypeof reservation required. The choices are: 

VX_NOEXTEND 

The file may not be extended once the current reservation is exceeded. The reservation 
may be increased if necessary by another invocation of the ioctl, but the file will not be 
automatically extended. 

VXTRIM 

The reservation for the file is to be trimmed to the current file size upon last close by all 
processes that have the file open. 

VXCONTIGUOUS 

The reservation must be allocated contiguously (as a single extent). ext_size will 
become the fixed extent size for subsequent allocations, but has no affect on this one. The 
reservation will fail if the file has gone into indirect extents, unless the amount of space 
requested is the same as the indirect extent size. If the contiguous allocation request is 
done on an empty file, this will not happen. 

VXALIGN 

Align all new extents on an ext_size boundary relative to the starting block of an allo¬ 
cation unit. If VX CONTIGUOUS is also set, the single extent allocated during this invo¬ 
cation is not subject to the alignment restriction. 

VX_NORESERVE 

The reservation is to be made as a non-persistent allocation to the file. The on-disk inode 
will not be updated with the reservation information so that the reservation will not sur¬ 
vive a system crash. The reservation is associated with the file until the close of the file. 
The reservation is trimmed to the current file size on close. 

VX CHGSIZE 

The reservation is to be immediately incorporated into the file. The file's on-disk inode is 
updated with the size increased to include the reserved space. Unlike an fcntl(2) 
F_FREESP operation which "truncates up" (see fcntl (2)), the space included in the file is 
not initialized. This operation is restricted to users with appropriate privileges. 

Write permission to a file is required to set extent information, but any process that can open the file 
can get the extent information. Extent information only applies to regular files. Only one set of 
extent information is kept per file. Only the VX_ALIGN and VX_NOEXTEND allocation flags are 
persistent attributes of the file. Other allocation flags may have persistent effects, but are not visible 
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as allocation flags. VX_ALIGN, VX_NOEXTEND, and VX_TRIM are the only flags visible through 
the VX__GETEXT ioctl. 

The VX_SETEXT ioctl returns a 0 if the extent information is successfully set. If the operation fails, 
the return value is-1 and the external variable errno will beageneral DIAGNOSTIC. 

VX_GETEXT 

Get extent information. Return the extent information associated with fildes. The argument 
arg points to a structure of type vx_ext as defined in sys/f s/vx_ioctl. h. Only persistent 
extent attributes are visible. 

The VX_GETEXT ioctl returns a 0 if the extent information is successfully obtained. If the operation 
fails, the return value is -1 and the external variable errno will be a general DIAGNOSTIC. 

VXGETFSOPT 

Get file system options. The argument arg should be a pointer to an int. This command may be 
used by any user who can open the root inode on the file system. The options returned in arg are: 

VX_FSO_BLKCLEAR 

Indicates that all newly allocated blocks will be guaranteed to contain all zeros. (See the 
blkclear mount option of mount_vxfs(lM)). 

VXFSO CACHECLOSESYNC 

I ndicates that any non-logged changes to the inode or data will be flushed to disk when the 
file is closed. (Seethe mincache=closesync mount option of mountvxfs(lM)). 

VXFSO CACHEDIRECT 

Indicates that any non-synchronous I/O will be handled as if the VX„DIRECT cache 
advisory had been set on the file. Also, any non-logged changes to the inode or data will be 
flushed to disk when the file is closed. (See the mincache=direct mount option of 
mount_vxfs(lM)). 

VXFSO CACHEDSYNC 

I ndicates that any writes that don't have either 0_SYNC or the VX_DIRECT advisory set 
will be handled as if the VX_DSYNC advisory had been set on the file. Also, any non- 
logged changes to the inode or data will be flushed to disk when the file is closed. (See the 
mincache=dsync mount option of mount vxfs(lM)). 

VX_FSO_NODATAINLOG 

Indicates that intent logging of user data for synchronous writes is disabled. (See the 
nodatainlog mount option of mount vxfs(lM)). 

VX_FSO_NOLOG 

Indicates that intent logging of structural changes to the file system is disabled. (See the 
nolog mount option of mount_vxfs(lM)). 

VXFSOOSYNCCLOSESYNC 

I ndicates that any non-logged changes to the inode or data will be flushed to disk when a 
file accessed with 0_SYNC is closed. (Seethe convosync=closesync mount option 
of mount_vxfs(lM)). 

VX_F S 00 S YNCDIRECT 

I ndicates that any 0_SYNC I/O will be handled as if the VX__DIRECT cache advisory had 

been set on the file instead. Also, any non-logged changes to the inode or data will be 

flushed to disk when a file accessed with 0_SYNC is closed. (See the 

convosync=direct mount option of mount vxfs(lM)). 

VX_F S 00 S YNCD SYNC 

Indicates that any 0_SYNC writes will be handled as if the VX_DSYNC cache advisory 
had been set on the file instead. Also, any non-logged changes to the inode or data will be 
flushed to disk when a file accessed with 0_SYNC is closed. (See the 

convosync=dsync mount option of mount vxfs(lM)). 

VXFSOSNAPPED 

I ndicates that a snapshot backup of this file system is being maintained. 

VXFSOSNAPSHOT 

I ndicates that this file system is a snapshot backup of another filesystem. 
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VX_FSO_VJFS 

I ndicates that the VxFS Advanced package is not installed. 

The VX_GETFSOPT ioctl returns a 0 if the file system options are successfully obtained. If the 
operation fails, the return value is -1 and the external variable errno will be a general DIAGNOS¬ 
TIC. 

VX_FREEZE 

Sync then freeze the file system. Once frozen, all further operations against the file system block 
until a VX THAW operation is received. The argument arg is a timeout value expressed in seconds. 
If a VXTHAW operation is not received within the specified timeout interval, the file system will per¬ 
form a VX THAW operation automatically. 

This command may only be used by a user with appropriate privilege, on the root directory of the file 
system. 

The VX FREEZE ioctl returns a 0 if the file system is successfully frozen. If the operation fails, the 
return value is -1 and the external variable errno will be a general DIAGNOSTIC. 

VXTHAW 

Unblock a file system that has been frozen by a VX_FREEZE operation. The argument arg should 
beNULL. The process that is to issue a VX_THAW operation must have the root directory of the file 
system open, and must ensure that it does not access the file system after the file system has been 
frozen, to ensure that the process itself does not block. 

This command may only be used by a user with appropriate privilege, on the root directory of the file 
system. 

The VX_THAW ioctl returns a 0 if the file system is successfully unfrozen. If the operation fails, the 
return value is -1 and the external variable errno will beageneral DIAGNOSTIC or oneofthefol- 
I owing: 


DIAGNOSTICS 

The following 

EACCESS 

EAGAIN 

EFBIG 

EINVAL 

EPERM 

ENODEV 

EROFS 

EIO 

ENOSPC 

EFAULT 


values are returned in errno upon operation failures: 

The calling process does not have write access to the file specified by fildes. 

The file system is not currently frozen. 

An attempt was made to reserve space larger than the maximum file size limit for this pro¬ 
cess. 

The command or argument is invalid. 

The process does not have appropriate privilege. 

The file specified by fildes is not the root directory of a vxfs filesystem. 

The file system is mounted read-only. 

An I/O error occurred while attempting to perform the operation. 

Requested space could not be obtained. 

An address specified by an argument is invalid. 


NOTES 

Under certain circumstances, fsadmflM) may reorganize the extent map of a file in such a way as to make 
it less contiguous. However, it will not change the geometry of a file that has a fixed extent size. 


SEE ALSO 

mount_vxfs(lM), getrlimit(2), ioctl(2), ulimit(2). 
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NAME 

xopen_networking - X/Open Networking I nterfaces 

DESCRIPTION 

X/Open has defined XTI, Sockets, and IP Address Resolution interfaces in X/Open CAE Specification, 
Networking Services, Issue 4 (UNIX 95) and X/Open CAE Specification, Networking Services, Issue 5 
(UNIX 98). For a detailed description of these interfaces, please refer to the above specifications or to the 
book Go Solo, which is published by Prentice Flail. Go Solo also includes a CD ROM which contains the 
above specification to other SPEC 1170 man pages. 

COMPILING ENVIRONMENT 

Using any of the Networking Services(XTI, sockets) requires _XOPEN_SOURCE to be defined and 
_XOPEN_SOURCE EXTENDED to be defined with the value 1. 

The _XOPEN_SOURCE macro may be defined automatically by the compilation environment, but to ensure 
portability the application should define the macro either on the compilation command line, or at the begin¬ 
ning of each source module prior to the inclusion of any headers. The _XOPEN_SOURCE_EXTENDED 
macro will not be automatically defined by the compilation environment. 

The c89 and cc utilities recognize the additional -1 operand for standard libraries: 

-1 xnet This operand makes visible all functions referenced in the above specification. 


AUTHOR 

X/ Open XTI, Sockets, and IP Address Resolution interfaces were developed by X/Open Company Limited. 

SEE ALSO 

XTI library functions: 

t_accept(3), t_alloc(3), t_bind(3), t_close(3), t_connect(3), t_error(3), t_free(3), t_getinfo(3), t_getprotaddr(3), 
t_getstate(3), t_listen(3), tJook(3), t_open(3), t_optmgmt(3), t_rcv(3), t_rcvconnect(3), t_rcvdis(3), 
t_rcvrel(3), t_rcvudata(3), t_rcvuderr(3), t_snd(3), t_snddis(3), t_sndrel(3), t_sndudata(3), t_strerror(3), 
t_sync(3), t_unbind(3). 

Sockets I nterfaces: 

accept(2), bind(2), dose(2), connect(2), fcntl(2), fgetpos(3S), fsetpos(3S), ftelI(3S), getpeername(2), getsock- 
name(2), getsockopt(2), listen(2), lseek(2), polI(2), read(l), recv(2), recvfrom(2), recvmsg(2), select(2), 
send(2), sendmsg(2), sendto(2), setsockopt(2), shutdown(2), socket(2), socketpair(2), write(l). 

IP Address Resol ution I nterfaces: 

endhostent(3N), endnetent(3N), endprotoent(3N), endservent(3N), gethostbyaddr(3N), gethostname(3N), 
getnetbyaddr(3N), getprotobynumber(3N), getservbyport(3N), htonl(3N), inet_addr(3N), ntohl(3N), 
sethostent(3N), setnetent(3N), setprotoent(3N), setservent(3N). 
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NAME 

intro - introduction to glossary section 

DESCRIPTION 

This section contains a glossary of common HP-UX terms. References to other HP-UX documentation are 
included as appropriate. Entities in italics with a following parenthesized roman number, such as sh(l), 
wait(2), or fopen(3S) refer to entries in theother sections of this manual. Items in bold face refer to other 
entries in this glossary. Any italicized manual names refer to separate manuals that are either included 
with your system or availableseparately. 

The definitions specifically reflect the HP-UX operating system, although some terms and definitions are 
also derived from those in the emerging IEEE POSIX standards and the X/Open Portability Guide. 
Differences in wording exist to more specifically reflect the characteristics of the HP-UX system. 

SEE ALSO 

I ntroduction(9) 
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NAME 

glossary - a description of common HP-UX terms 

DESCRIPTION 

HP-UX and other UNIX-like systems use a specialized vocabulary in which certain words and terms have 
very specific meanings. This glossary is intended as an aid in promoting exactness in use of these special¬ 
ized terms whose meanings sometimes differ from those that might be encountered in other environments. 


GLOSSARY ENTRIES 

. (dot) A special file name that refers to the current directory. It can be used alone or at the 

beginning of a directory path name. See also path name resolution. The dot also func¬ 
tions as a special command in the Bourne and Korn shells, and has special meaning in text 
editors and formatters, in parsing regular expressions and in designatingfile names. 

. . (dot-dot) A special file name that refers to the parent directory. If it begins a path name, dot- 
dot refers to the parent of the current directory. If it occurs in a path name, dot-dot 
refers to the parent directory of the directory preceding dot-dot in the path name string. 
As a special case, dot-dot refers to the current directory in any directory that has no 
parent (most often, the root directory). See also path name resolution. 


.o (dot-oh) The suffix customarily given to a relocatable object file. The term dot-oh file is sometimes 
used to refer to a relocatable object file. The format of such files is sometimes called dot-oh 
format. Seea.out(4). 


a.out The name customarily given to an executable object code file on HP-UX. The format is 

machine-dependent, and is described in a.out(4) for each implementation. Object code that 
is not yet linked has the same format, but is referred to as a . o (dot-oh) file, a . out is 
also the default output file name used by the linker, Id(1). 


absolute path name 

A path name beginning with a slash (/). It indicates that the file's location is given relative 
to the root directory (/), and that the search begins there. 


access The process of obtaining data from or placing data in storage, or the right to use system 

resources. Accessibility is governed by three process characteristics: the effective user ID, 
the effective group ID, and the group access list. The access(2) system call determines 
accessibility of a file according to the bit pattern contained in its amode parameter, which is 
constructed to read, write, execute or check the existence of a file. The access(2) system 
call uses the real user ID instead of the effective user ID and the real group ID instead 
of the effective group ID. 


access groups 

The group access list is a set of supplementary group IDs used in determining resource 
accessibility. Access checks are performed as described below in file access permissions. 

access mode An access mode is a form of access permitted to a file. Each implementation provides 
separate read, write, and execute/search access modes. 

address A number used in information storage or retrieval to specify and identify memory location. 

An address is used to mark, direct, indicate destination, instruct or otherwise communi¬ 
cate with computer elements. 

In mail, address is a data structure whose format can be recognized by all elements 
involved in transmitting information. On a local system, this might be as simple as the 
user's login name, while in a networked system, address specifies the location of the 
resource to the network software. 

I n a text editor (such as vi, ex, ed, or sed), an address locates the line in a file on which 
a given instruction is intended. 

For adb, the address specifies at what assembly-language instruction to execute a given 
command. 

In disk utilities such as fsdb, address might refer to a raw or block special file, the 
inode number, volume header, or other file attribute. 

I n the context of peripheral devices, address refers to a set of values that specify the loca¬ 
tion of an I/O device to the computer. The exact details of the formation of an address 
differ between systems. On Series 700 systems, the address consists of up to two elements: 
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the select code, and the function number. 

address space 

The range of memory locations to which a process can refer. 

affiliation See terminal affiliation. 

appropriate privileges 

Each implementation provides a means of associating privileges with a process for function 
calls and function call options requiring special privileges. In the HP-UX system, 
appropriate privileges refers either to superuser status or to a privilege associated with 
privilege groups (seesetprivgrp(lM)). 

archive A file comprised of the contents of other files, such as a group of object files (that is, .o) 
used by the linker, Id(1)). An archive file is created and maintained by ar(l) or similar pro¬ 
grams, such astar(l) or cpio(l). An archive is often called a library. 

ASCII An acronym for American Standard Code for I nformation I nterchange. ASCII isthetradi- 

tional System V coded character set and defines 128 characters, including both control char¬ 
acters and graphic characters, each of which is represented by 7-bit binary values ranging 
from 0 through 127 decimal. 

background process group 

Any process group that is a member of a session which has established a connection with a 
control ling terminal that is not in the foreground process group. 

backup The process of making a copy of all or part of the file system in order to preserve it, in case 
a system crash occurs (usually due to a power failure, hardware error, etc.). This is a 
highly recommended practice. 

block (1) The fundamental unit of information HP-UX uses for access and storage allocation on a 

mass storage medium. The size of a block varies between implementations and between 
file systems. In order to present a more uniform interface to the user, most system calls 
and utilities use block to mean 512 bytes, independent of the actual block size of the 
medium. This is the meaning of block unless otherwise specified in the manual entry. 

(2) On media such as 9-track tape that write variable length strings of data, the size of 
those strings. Block is often used to distinguish from record; a block contains several 
records, whereas the number of records denotes the blocking factor. 

block special file 

A special file associated with a mass storage device (such as a hard disk or tape cartridge 
drive) that transfers data in multiple-byte blocks, rather than by series of individual bytes 
(see character special file). Block special files can be mounted. A block special file 
provides access to the device where hardware characteristics of the device are not visible. 

boot, boot-up The process of loading, initializing, and running an operating system. 

boot area A portion of a mass storage medium on which the volume header and a "bootstrap" pro¬ 
gram used in booting the operating system reside. The boot area is reserved exclusively 
for use by HP-UX. 

boot ROM A program residing in ROM (Read-Only Memory) that executes each time the computer is 
powered up and is designed to bring the computer to a desired state by means of its own 
action. The first few instructions of a bootstrap program are sufficient to bring the 
remainder of the program into the computer from an input device and initiate functions 
necessary for computation. The function of the boot ROM is to run tests on the computer's 
hardware, find all devices accessiblethrough the computer, and then load either a specified 
operating system or the first operating system found according to a specific search algo¬ 
rithm. 

bus address A number which makes up part of the address HP-UX uses to locate a particular device. 

The bus address is determined by a switch setting on a peripheral device which allows the 
computer to distinguish between two devices connected to the same interface. A bus 
address is sometimes called a "device address". 

character An element used for the organization, control, or representation of text. Characters include 

graphic characters and control characters. 
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character set A set of characters used to communicate in a native or computer language. 

character special file 

A special file associated with I/O devices that transfer data byte-by-byte. Other byte-mode 
I/O devices include printers, nine-track magnetic tape drives, and disk drives when 
accessed in "raw" mode (see raw disk). A character special file has no predefined struc¬ 
ture. 

child process A new process created by a pre-existing process via the fork(2) system call. The new pro¬ 
cess is thereafter known to the pre-existing process as its child process. The pre-existing 
process is the parent process of the new process. See parent process and fork. 

clock tick A rate used within the system for scheduling and accounting. It consists of the number of 
intervals per second as defined by CLK__TCK that is used to express the value in type 
clock_t. CLK_TCK was previously known as the defined constant HZ. 

coded character set 

A set of unambiguous rules that establishes a character set and the one-to-one relationship 
between each character of the set and its corresponding bit representation. ASCII is a 

coded character set. 

collating element 

The smallest entity used in collation to determine the logical ordering of strings (that is, the 
collation sequence). To accommodate native languages, a collating element consists of 
either a single character, or two or more characters collating as a single entity. The 
current value of the LANG environment variable determines the current set of collating ele¬ 
ments. 

collation The logical ordering of strings in a predefined sequence according to rules established by 
precedence. These rules identify a collation sequence among the collating elements and 
also govern the ordering of strings consisting of multiple collating elements, to accommo¬ 
date native languages. 

collation sequence 

The ordering sequence applied to collating elements when they are sorted. To accommo¬ 
date native languages, collation sequence can be thought of as the relative order of col¬ 
lating elements as set by the current value of the LANG environment variable. Charac¬ 
ters can be omitted from the collation sequence, or two or more collating elements can be 
given the same relative order (seestring(3C)). 

command A directive to perform a particular task. HP-UX commands are executed through a com¬ 
mand interpreter called a shell. HP-UX supports several shells, including the Bourne 
shell (sh-bourne(l)), thePOSIX shell (sh-posix(l)), the C shell (csh(l)), and the Korn shell 
(ksh(l)). See sh(l) for more information about supported shells. Most commands are car¬ 
ried out by an executable file, called a utility, which might take the form of a stand-alone 
unit of executable object code (a program) or a file containing a list of other programs to 
execute in a given order (a shell script). Scripts can contain references to other scripts, as 
well as to object-code programs. A typical command consists of the utility name followed 
by arguments that are passed to the utility. For example, in the command, "is mydirec- 
tory", "is" is the utility name and "mydirectory" is an argument passed to the "is" util¬ 
ity. 

command interpreter 

A program which reads lines of text from standard input (typed at the keyboard or read 
from a file), and interprets them as requests to execute other programs. A command inter¬ 
preter for HP-UX iscalled a shell. Seesh(l) and related manual entries. 

Command Set 1980 

See C S/80. 

composite graphic symbol 

A graphic symbol consisting of a combination of two or more other graphic symbols in a sin¬ 
glecharacter position, such as a diacritical mark and a basic letter. 

control character 

A character other than a graphic character that affects the recording, processing, transmis¬ 
sion, or interpretation of text. In the ASCI I character set, control characters are those 
in the range 0 through 31, and 127. Control characters can be generated by holding down 

Section 9-4 - 3 - HP-UX Release 11.0: October 1997 


glossary(9) 


glossary(9) 


the control key (which may be labeled CTRL, CONTROL, or CNTL depending on your ter¬ 
minal), and pressing a character key (as you would use SHI FT). These two-key sequences 
are often written as, for example, Control-D, Ctrl-D, or ~D, where ~ stands for the control 
key. 

controlling process 

The session leader that establishes the connection to the controlling terminal. Should 
the terminal subsequently cease to be a controlling terminal for this session, the session 
I eader ceases to be the control ling process. 

controlling terminal 

A terminal that is associated with a session. Each session can have at most one controlling 
terminal associated with it and a controlling terminal is associated with exactly one session. 
Certain input sequences from the controlling terminal cause signals to be sent to all 
processes in theforeground process group associated with the control ling terminal. 

Coordinated Universal Time (UTC) 

See Epoch. 

CS/80, CS-80 A family of mass storage devices that communicate with the controlling computer by means 
of a series of commands and data transfer protocol referred to as the CS/80 (Command Set 
1980) command set. This command set was implemented in order to provide better 
forward/backward compatibility between models and generations of mass storage devices as 
technological advances develop. Some mass storage devices support only a subset of the 
full CS/80 command set, and are usually referred to as SS/80 (Subset 1980) devices. 

crash The unexpected shutdown of a program or system. If the operating system crashes, this is 

a "system crash", and requires the system to be re-booted. 

current directory 

See working directory. 

current working directory 

See working directory. 

daemon A process which runs in the background, and which is usually immune to termination 
instructions from a terminal. Its purpose is to perform various scheduling, clean-up, and 
maintenance jobs. Ipsched(lM) is an example of a daemon. It exists to perform these 
functions for line printer jobs queued by lp(l). An example of a permanent daemon (that 
is, one that should never die) iscron(lM). 

data encryption 

A method for encoding information in order to protect sensitive or proprietary data. For 
example, HP-UX automatically encrypts all users' passwords. The encryption method used 
by HP-UX converts ASCII text into a base-64 representation using the alphabet ., /, 0-9, 
A-Z, a-z. See passwd(4) for the numerical equivalents associated with this alphabet. 

default search path 

The sequence of directory prefixes that sh(l), time(l), and other HP-UX commands apply in 
searching for a file known by an relative path name (that is, a path name not beginning 
with a slash (/)). It is defined by the environment variable PATH (see environ(5)). 
login(l) sets PATH equal to : /usr/bin, which means that your working directory is the 
first directory searched, followed by /usr/bin. The search path can be redefined by 
modifying the value of PATH. This is usually done in /etc/profile, and/or in the 
.profile filefound in the home directory. 

delta A term used in the Source Code Control System (SCCS) to describe a unit of one or 

more textual changes to an SCCS file. Each time an SCCS file is edited, changes made to 
the file are stored separately as a delta. The get(l) command is then used to specify which 
deltas are to be applied to or excluded from the SCCS file, thus yielding a particular version 
ofthefile. Contrast this with the vi or ed editor, which incorporates changes into the file 
immediately, eliminating any possibility of obtaining a previous version of that file. A simi¬ 
lar capability is provided by RCS files (see rcsintro(5)), 

demon Improper spelling of the U NIX word daemon. 

device A computer peripheral or an object that appears to an application as such. 
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device address 

See bus address. 


device file 
directory 


dot 

dot-dot 


See special file. 

A file that provides the mapping between the names of files and their contents, and is mani¬ 
pulated by the operating system alone. For every file name contained in a directory, that 
directory contains a pointer to the file's inode; The pointer is called a link. A file can have 
several links appearing anywhere on the same file system. Each user is free to create as 
many directories as needed (using mkdir(l)), provided that the parent directory of the 
new directory gives the permission to do so. Once a directory has been created, it is ready 
to contain ordinary files and other directories. An HP-UX directory is named and behaves 
exactly like an ordinary file, with one exception: no user (including the superuser) is 
allowed to write data on the directory itself; this privilege is reserved for the HP-UX 
operati ng system. 

By convention, a directory contains at least two links, . and . ., referred to as dot and 
dot-dot respectively. Dot refers to the directory itself and dot-dot refers to its parent 
directory. A directory containing only . and . . is considered empty. 

See . (dot). 

See . . (dot-dot). 


dot-oh See . o (dot-oh). 


dot-ohfile See .o (dot-oh). 


dot-oh format 

See . o (dot-oh). 


downshifting The conversion of an uppercase character to its lowercase representation. 

dynamic loader 

A routine invoked at process startup time that loads shared libraries into a process'address 
space. The dynamic loader also resolves symbolic references between a program and the 
shared libraries, and initializes the shared libraries' linkage tables. See did.si (5) for details. 

effective group ID 

Every process has an effective group ID that is used to determine file access permis¬ 
sions. A process's effective group ID is determined by thefile (command) that process is 
executing. If that file's set-group-1 D bit is set (located in the mode of the file, see mode), 
the process's effective group ID is set equal to the file's group ID. This makes the process 
appear to belong to the file's group, perhaps enabling the process to access files that must 
be accessed in order for the program to execute successfully. If the file's set-group-1 D bit is 
not set, the process's effective group ID is inherited from the process's parent. The set¬ 
ting of the process's effective group ID lasts only as long as the program is being exe¬ 
cuted, after which the process's effective group ID is set equal to its real group ID. See 
group, real group ID, and set-group-1 D bit. 

effective user ID 

A process has an effective user ID that is used to determine file access permissions 

(and other permissions with respect to system calls, if the effective user ID is 0, which 
means superuser). A process's effective user ID is determined by the file (command) that 
process is executing. If that file's set-user-1 D bit is set (located in the mode of the file, see 
mode), the process's effective user ID is set equal to the file's user ID. This makes the pro¬ 
cess appear to be the file's owner, enabling the process to access files which must be 
accessed in order for the program to execute successfully. (Many HP-UX commands which 
are owned by root, such as mkdir and mail, have their set-user-1 D bit set so other 
users can execute these commands.) If the file's set-user-1 D bit is not set, the process's 
effective user ID is inherited from that process's parent. See real user ID and set-user - 
ID bit. 


end-of-file (EOF) 

(1) The data returned when attempting to read past the logical end of a file via stdio(3S) 
routines. I n this case, end-of-file is not properly a character. 

(2) TheASCII character Ctrl-D. 
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(3) A character defined by stty(l) or ioctl (2) (see termio(7)) to act as end-of-file on your ter¬ 
minal. Usually this is Ctrl-D. 

(4) The return valuefrom read(2) that indicates end of data. 

environment The set of defined shell variables (such as EXINIT, HOME, PATH, SHELL, TERM, and oth¬ 
ers) that define the conditions under which user commands run. These conditions can 
include user terminal characteristics, home directory, and default search path. Each shell 
variable setting in the current process is passed on to all child processes that are created, 
provided that each shell variable setting has been exported via the export command (see 
sh(l)). Unexported shell variable settings are meaningful only to the current process, and 
any child processes created get the default settings of certain shell variables by executing 
/etc/profile , $HOME/ . profile, or $HOME/ . login . 

EOF See end-of-file. 

Epoch The time period beginning at 0 hours, 0 minutes, 0 seconds, Coordinated Universal 

Time(UTC)onJ anuaryl, 1970. I ncrements quantify theamount of time elapsed from the 
E poch to the referenced ti me. 

Leap seconds, which occur at irregular intervals, are not reflected in the count of seconds 
between the Epoch and the referenced time. (Fourteen leap seconds occurred in the years 
1970 through 1988.) 

FIFO special file 

A type of file. Data written to a FIFO is read on a first-in-first-out basis. Other charac¬ 
teristics are described in open(2), read(2), write(2) and lseek(2). 

file A stream of bytes that can be written to and/or read from. A file has certain attributes, 

including permissions and type. File types include regular file, character special file, 
block special file, FIFO special file, network special file, directory, and symbolic 
link. Every file must have a file name that enables the user (and many of the FIP-UX 
commands) to refer to the contents of the file. The system imposes no particular structure 
on the contents of a file, although some programs do. Files can be accessed serially or ran¬ 
domly (indexed by byte offset). The interpretation of file contents and structure is up to the 
programs that access the file. 

file access mode 

A characteristic of an open file description that determines whether the described file is 
open for reading, writing, or both. (See open(2).) 

file access permissions 

Every file in the file hierarchy has a set of access permissions. These permissions are 
used in determining whether a process can perform a requested operation on the file (such 
as opening a file for writing). Access permissions are established when a file is created via 
the open (2) or creat(2) system calls, and can be changed subsequently through the chmod(2) 
call. These permissions are read by stat(2) or fstat(2). 

File access controls whether a file can be read, written, or executed. Directory files use the 
execute permission to control whether or not the directory can be searched. 

File access permissions are interpreted by the system as they apply to three different 
classes of users: the owner of the file, the users in the file's group, and anyone else 
("other"). Every file has an independent set of access permissions for each of these classes. 
When an access check is made, the system decides if permission should be granted by 
checking the access information applicableto the caller. 

Read, write, and execute/search permissions on a file are granted to a process if any of the 
following conditions are met: 

• The process's effective user ID is superuser. 

• The process's effective user ID matches the user ID of the owner of the file and 
the appropriate access bit of the owner portion (0700) of the file mode is set. 

• The process's effective user ID does not match the user ID of the owner of the 
file, and either the process's effective group ID matches the group ID of the file, 
or the group ID of the file is in the process's group access list, and the appropriate 
access bit of the group portion (070) of the file mode is set. 
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• The process's effective user ID does not match the user ID of the owner of the 
file, and the process's effective group ID does not match the group ID of the file, 
and the group ID of the file is not in the process's group access list, and the 
appropriate access bit of the "other" portion (07) of the file mode is set. 

Otherwise, the corresponding permissions are denied. 

file descriptor 

A small unique, per-process, nonnegative integer identifier that is used to refer to a file 
opened for reading and/or writing. Each file descriptor refers to exactly one open file 
description. 

A file descriptor is obtained through system calls such as creat(2), fcntl(2), open(2), 
pipe(2), or dup(2). The file descriptor is used as an argument by calls such as read(2), 
write(2), ioctl (2), and dose(2). 

The value of a file descriptor has a range from 0 to one less than the system-defined max¬ 
imum. The system-defined maximum isthevalueNOFILE in <sys/param. h>. 

file group class 

A process is in the file group class of a file if the process is not the file owner class and 

if the effective group ID or one of the supplementary group I Ds of the process matches 
the group ID associated with the file. 

file hierarchy 

The collection of one or more file systems available on a system. All files in these file 
systems are organized in a single hierarchical structure in which all of the nonterminal 
nodes are directories. Because multiple links can refer to the same file, the directory is 
properly described as a directed graph. 

file name A string of up to 14 bytes (or 255 bytes on file systems that support long file names) used to 
refer to an ordinary file, special file, or directory. The byte values NUL (null) and slash (/) 
cannot be used as characters in a file name. Note that it is generally unwise to use *,?,,, 
[, or ] as part of file names because the shell attaches special meaning to these characters 
(seesh(l), csh(l), or ksh(l)). Avoid beginning a filename with -, +, or =, because to some 
programs, these characters signify that a command argument follows. A file name is some¬ 
times called a path name component. Although permitted, it is inadvisableto use charac¬ 
ters that do not have a printable graphic on the hardware you commonly use, or that are 
likely to confuse your terminal. 

file name portability 

File names should be constructed from the portable file name character set because the 
use of other characters can be confusing or ambiguous in certain contexts. 

file offset The file offset specifies the position in the file where the next I/O operation begins. Each 
open file description associated with either a regular file or special file has a file offset. 
There is no file offset specified for a pipe or FIFO. 

file other class 

A process is in the file other class if the process is not in the file owner class or file 
group class. 

file owner class 

A process is in the file owner class if the effective user ID of the process matches the 
user ID of the file. 

file permission bits 

See permission bits. 

file pointer A data element obtained through any of the fopen(3S) standard I/O library routines that 
"points to" (refers to) a file opened for reading and/or writing, and which keeps track of 
where the next I/O operation will take place in the file (in the form of a byte offset relative 
to the beginning of the file). After obtaining the file pointer, it must thereafter be used to 
refer to the open file when using any of the standard I/O library routines. (See stdio(3S) for 
a list of these routines.) 

file serial number 

A file-system-unique identifier for a given file, also known as the file's inode number. 
Each file serial number identifies exactly one inode. File serial numbers are not 
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necessarily unique across file systems in the file hierarchy, 
file status flags 

Part of an open file description. These flags can be used to modify the behavior of sys¬ 
tem calls that access the file described by the open file description. 

filesystem A collection of files and supporting data structures residing on a mass storage volume. A 
file system provides a name space for file serial numbers referring to those files. Refer to 
the System Administrator manuals supplied with your system for details concerning file 
system implementation and maintenance. 

file times update 

Each file has three associated time values that are updated when file data is accessed or 
modified, or when the file status is changed. These values are returned in the file charac¬ 
teristics structure, as described in <sys/stat .h> . For each function in FIP-UX that 
reads or writes file data or changes the file status, the appropriate time-related files are 
noted as "marked-for-update". When an update point occurs, any marked fields are set to 
the current time and the update marks are cleared. One such update point occurs when 
the file is no longer open for any process. Updates are not performed for files on read-only 
file systems. 

filter A command that reads data from the standard input, performs a transformation on the 

data, and writes it to the standard output. 

foreground process group 

Each session that has established a connection with a controlling terminal has exactly one 
process group of the session as a foreground process group of that controlling terminal. The 
foreground process group has certain privileges when accessing its controlling terminal that 
are denied to background process groups. See read (2) and write(2). 

foreground process group ID 

The process group ID of the foreground process group. 

fork An FIP-UX system call (see fork(2)), which, when invoked by an existing process, causes a 

new process to be created. The new process is called the child process; the existing pro¬ 
cess is called the parent process. The child process is created by making an exact copy of 
the parent process. The parent and child processes are able to identify themselves by the 
value returned by their corresponding fork call (seefork(2) for details). 

function number 

On Series 700 systems, when two or more interfaces reside on a single interface card, each 
interface is treated as a separate function and is assigned a corresponding uniquefunction 
number. 

graphic character 

A character other than a control character that has a visual representation when hand¬ 
written, printed, or displayed. 

group See group ID. 

group ID Associates zero or more users who must all be permitted to access the same set of files. 

The members of a group aredefined in thefiles /etc/passwd and /etc/logingroup 
(if it exists) via a numerical group ID that must be between zero and UID_MAX, inclusive. 
Users with identical group IDs are members of the same group. An ASCII group name is 
associated with each group ID in the file /etc/group . A group ID is also associated with 
every file in the file hierarchy, and the mode of each file contains a set of permission bits 
that apply only to this group. Thus, if you belong to a group that is associated with a file, 
and if the appropriate permissions are granted to your group in the file's mode, you can 
access the file. When the identity of a group is associated with a process, a group ID value 
is referred to as a real group ID, an effective group ID, a supplementary group ID, 
or a saved group ID. See also privileged group and set-group-ID bit. 

group access list 

A set of supplementary group IDs used in determining resource accessibility. Access 
checks are performed as described in file access permissions. 

hierarchical directory 

A directory (or filesystem) structure in which each directory can contain other directories 
as well as files. 
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home directory 

The directory name given by the value of the environment variable HOME. When you first 
log in, login(l) automatically sets HOME to your login directory. You can change its value 
at any time. This is usually done in the .profile file contained in your login direc¬ 
tory. Setting HOME does not affect your login directory; it simply gives you a convenient 
way of referring to what is probably your most commonly used directory. 

host name An ASCII string of at most 8 characters (of which only 6 are supported by all the various 
manufacturers' UNIX-like operating systems) which uniquely identifies an HP-UX system 
on a uucp(l) network. The host name for your system can be viewed and/or set with the 
hostname(l) command. Systems without a defined host name are described as "unknown" 
on the uucp(l) network. Do not confuse a host name with a node name, which is a string 
that uniquely identifies an HP-UX system on a Local Area Network (LAN). Although your 
host and node names may be identical, they are set and used by totally different software. 
See node name. 

image The current state of your computer (or your portion of the computer, on a multiuser sys¬ 

tem) during the execution of a command. Often thought of as a "snapshot" of the state of 
the machine at any particular moment during execution. 

init A system process that performs initialization, istheancestor of every other process in the 

system, and is used to start login processes, init usually has a process ID of 1. See 
init(lM). 

interleave factor 

A number that determines the order in which sectors on a mass storage medium are 
accessed. It can be optimized to make data acquisition more efficient. 

inode An inode is a structure that describes a file and is identified in the system by a file serial 

number. Every file or directory has associated with it an inode. Permissions that specify 
who can access the file and how are kept in a 9-bit field that is part of the inode. The 
inode also contains the file size, the user and group ID of the file, the number of links, and 
pointers to thedisk blocks where thefile's contents can be found. Each connection between 
an inode and its entry in one or more directories is called a link. 

inode number 

See file serial number. 

Internal Terminal Emulator (ITE) 

The "device driver" code contained in the HP-UX kernel that is associated with the 
computer's built-in keyboard and display or with a particular keyboard and display con¬ 
nected to the computer, depending on the Series and Model of system processor. See sys¬ 
tem console and the System Administrator manuals supplied with your system for details. 

internationalization 

The concept of providing software with the ability to support the native language, local 
customs, and coded character set of the user. 

interrupt signal 

The signal sent by SIGINT (see signal (2)). Thissignal generally terminates whatever pro¬ 
gram you are running. The key which sends this signal can be redefined with ioctl (2) or 
stty(l) (see termio(7)). It is often the ASCII DEL (rubout) character (the DEL key) or the 
BREAK key. Ctrl-C is often used instead. 

intrinsic See system call. 

I/O redirection 

A mechanism provided by the HP-UX shell for changing the source of data for standard 
input and/or the destination of data for standard output and standard error. See sh(l). 

ITE See Internal Terminal Emulator. 

job control J ob control allows users to selectively stop (suspend) execution of processes and continue 
(resume) their execution at a later time. 

The user employs this facility via the interactive interface jointly supplied by the system 
terminal driver and certain shells (see sh(l)). The terminal driver recognizes a user- 
defined "suspend character", which causes the current foreground process group to stop and 
the user's job control shell to resume. The job control shell provides commands that 
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kernel 

LANG 

library 


LIF 

line 

link 


link count 
linker 


continue stopped process groups in either the foreground or background. The terminal 
driver also stops a background process group when any member of the background process 
group attempts to read from or write to the user's terminal. This allows the user to finish 
or suspend the foreground process group without interruption and continue the stopped 

background process group at a more convenient time. 

See stty(l), sh(l), and related shell entries for usage and installation details, and the shell 
entries plus signal (2) and termio(7) for implementation details. 

The HP-UX operating system. The kernel is the executable code responsible for managing 
the computer's resources, such as allocating memory, creating processes, and scheduling 
programs for execution. The kernel resides in RAM (random access memory) whenever 
HP-UX is running. 

An environment variable used to inform a computer process of the user's requirements for 

native language, local customs, and coded character set. 

A file containing a set of subroutines and variables that can be accessed by user programs. 
Libraries can be either archives or shared libraries. For example, /usr/lib/libc. a 
and /usr/lib/libc. si are libraries containings all functions of Section 2 and all func¬ 
tions of Section 3 that are marked (3C) and (3S) in the HP-UX Reference Manual. Simi¬ 
larly, /usr/lib/libm. a and /usr/lib/libm.si are libraries containing all func¬ 
tions in Section 3 that are marked (3M) in the HP-UX Reference Manual. See intro(2) and 
intro(3). 

See Logical Interchange Format. 

A sequence of text characters consisting of zero or more nonnewline characters plus a ter¬ 
minating newline character. 

Link is a synonym for directory entry. It is an object that associates a file name with 
any type of file. The information constituting a link includes the name of the file and 
where the contents of that file can be found on a mass storage medium. One physical file 
can have several links to it. Several directory entries can associate names with a given file. 
If the links appear in different directories, the file may or may not have the same name in 
each. However, if the links appear in one directory, each link must havea uniquenamein 
that directory. Multiple links to directories are not allowed (except as created by a user 
with appropriate privileges). See In(1), link(2), unlink(2), and symbolic link. 

Also, to prepare a program for execution; see linker. 

The number of directory entries that refer to a particular file. 

A program that combines one or more object programs into one program, searches libraries 
to resolve user program references, and builds an executable file in a. out format. This 
executable file is ready to be executed through the program loader, e<ec(2). The linker is 
invoked with the Id(1) command. The linker is often called a link editor. 


local customs The conventions of a geographical area or territory for such things as date, time and 
currency formats. 

localization The process of adapting existing software to meet the local language, customs, and charac¬ 
ter set requirements of a particular geographical area. 

Logical Interchange Format (LIF) 

A standard format for mass storage implemented on many Hewlett-Packard computers to 
aid in media transportability. The lif*(l) commands are used to perform various LIF func¬ 
tions. 


login The process of gaining access to HP-UX. This consists of successful execution of the login 

sequence defined by login(l), which varies depending on the system configuration. It 
requests a login name and possibly one or more passwords. 

login directory 

The directory in which you are placed immediately after you log in. This directory is 
defined for each user in the file /etc/passwd. The shell variableHOME is set automati¬ 
cally to your login directory by login(l) immediately after you log in. See home direc¬ 
tory. 
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magic number 

The first word of an a. out-format or archive file. This word contains the system ID, 
which states what machine (hardware) the file will run on, and the file type (executable, 
sharableexecutable, archive, etc.). 

major number 

A number used exclusively to create special files that enable I/O to or from specific devices. 
This number indicates which device driver to use for the device. Refer to mknod(2) and the 
System Administrator manual supplied with your system for details. 

message catalog 

Program strings, such as program messages and prompts, are stored in a message catalog 
corresponding to a particular geographical area. Retrieval of a string from a message 
catalog is based on the valueof the user's LANG environment variable(see LANG). 

message queue identifier (msqid) 

A unique positive integer created by a msgget(2) system call. Each msqid has a message 
queue and a data structure associated with it. The data structure is referred to as 
msqid_ds and contains the foil owing members: 


struct 

ipc_perm msg_perm; 

/* 

operation permission */ 

ushort 

msg_qnum; 

/* 

number of msgs on q */ 

ushort 

msg_qbytes; 

/* 

max number of bytes on q */ 

ushort 

msg_lspid; 

/* 

pid of last msgsnd operation */ 

ushort 

msg_lrpid; 

/* 

pid of last msgrcv operation */ 

time_t 

msg_stime; 

/* 

last msgsnd time */ 

time_t 

msg_rtime; 

/* 

last msgrcv time */ 

time_t 

msg_ctime; 

/* 

last change time */ 



/* 

Times measured in secs since */ 



/* 

00:00:00 GMT, Jan. 1, 1970 */ 


Message queue identifiers can be created using ftok(3C). 

msg_perm is a ipc_joerm structure that specifies the message operation permission (see 
below). This structure includes the foil owing members: 


ushort 

cuid; 

/* 

creator user id */ 

ushort 

cgid; 

/* 

creator group id */ 

ushort 

uid; 

/* 

user id */ 

ushort 

gid; 

/* 

group id */ 

ushort 

mode; 

/* 

r/w permission */ 


msg_qnum is the number of messages currently on the queue. msg_qbytes is the max¬ 
imum number of bytes allowed on thequeue. msg_lspid istheprocess id of thelast pro¬ 
cess that performed a msgsnd operation. msg_lrpid is the process id of the last process 
that performed a msgrcv operation. msg_stime is the time of the last msgsnd opera¬ 
tion, ms g_r time is the time of the last msgrcv operation, and msg_ctime is the time 
of the last msgctl (2) operation that changed a member of the above structure. 

message operation permissions 

In the msgop(2) and msgctl (2) system call descriptions, the permission required for an 
operation is indicated for each operation. Whether a particular process has these permis¬ 
sions for an object isdetermined by theobject's permission mode bits as follows: 

00400 Read by user 

00200 Write by user 

00060 Read, Write by group 

00006 Read, Write by others 

Read and Write permissions on a msqid are granted to a process if one or more of the fol¬ 
lowing are true: 

• The process's effective user ID is superuser. 

• The process's effective user ID matches msg_perm. [cjuid in the data structure 
associated with msqid and the appropriate bit of the "user" portion (0600) of 
msg_perm.mode is set. 
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• The process's effective user ID does not match msgjperm. [c]uid and either the 
process's effective group ID matches msg_perm. [c]gid or one of 
msg_joerm. [c]gid is in the process's group access list and the appropriate bit of 
the "group" portion (00060) of msg_perm. mode is set. 

• The process's effective user ID does not match msg_j?erm. [c]uid and the 
process's effective group ID does not match msg_perm. [c]gid and neither of 
msg_perm. [c]gid is in the process's group access list and the appropriate bit of 
the "other" portion (06) of msg_perm. mode is set. 

Otherwise, the corresponding permissions are denied. 

metacharacter 

A character that has special meaning to the HP-UX shell, as well as to commands such as 
ed, find, and grep (see ed(l), find(l), and grep(l)). The set of metacharacters includes: 
!, ', and |. Refer to sh(l) and the related shell manual 

entries for the meaning associated with each. See also regular expression. 

minor number 

A number that is an attributeof special files, specified duringtheir creation and used when¬ 
ever they are accessed, to enable I/O to or from specific devices. This number is passed to 
the device driver and is used to select which device in a family of devices is to be used, and 
possibly some operational modes. The exact format and meaning of the minor number is 
both system and driver dependent. Refer to the System Administrator manuals supplied 
with your system for details. 

On Series 700 systems, a minor number indicates the device address, function number, 
and driver-dependent bits. On Series 800 systems, a minor number is an index into a 
table in the kernel. 

mode A 16-bit word associated with every file in the file system, stored in the inode. The least- 

significant 12 bits of the mode determine the read, write, and execute permissions for the 
file owner, file group, and all others, and contain the set-user-1 D, set-group-1 D, and "sticky" 
(save text image after execution) bits. The least-significant 12 bits can be set by the 
chmod(l) command if you are the file's owner or the superuser. The sticky bit on a regular 
file can only be set by the superuser. These 12 bits are sometimes referred to as permis¬ 
sion bits. The most-significant 4 bits specify thefiletype for the associated file and are set 
as the result of open(2) or mknod(2) system calls. 

mountable file system 

A removable blocked file system contained on some mass storage medium with its own root 
directory and an independent hierarchy of directories and files. See block special file and 
mount(lM). 

msqid See message queue identifier, 

multiuser state 

The condition of the HP-UX operating system in which terminals (in addition to the system 
console) allow communication between the system and its users. By convention, multiuser 
run level is set at state 2, which is usually defined to contain all the terminal processes and 
daemons needed in a multiuser environment. Run levels are table driven, and are 
specified by init(lM), which sets the run level by looking at the file /etc/inittab . Do 
not confuse the multiuser system with the multiuser state. A multiuser system is a system 
which can have more than one user actively communicating with the system when it is in 
the multiuser state. The multiuser state removes the single-user restriction imposed by 
the single-user state (see single-user state, inittab(4)). 

native language 

A computer user's spoken or written language, such as Chinese, Dutch, English, French, 
German, Greek, Italian, Katakana, Korean, Spanish, Swedish, Turkish, etc. 

Native Language Support (NLS) 

A feature of HP-UX that provides the user with internationalized software and the applica¬ 
tion programmer with tools to develop this software. 

newline character 

The character with an ASCII valueof 10 (linefeed) used to separate lines of characters. It 
is represented by \n in the C language and in various utilities. The terminal driver 
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normally interprets a carriage-return/line-feed sequence sent by a terminal as a single new- 
line character (but seetty(7) for full details) 

See Native Language Support. 

An environment variable used to indicate the search path for message catalogs (see mes¬ 
sage catalog). 

A string of up to 31 characters, not including control characters or spaces, that uniquely 
identifies a node on a Local Area Network (LAN). The node name for each system is set 
by the npowerup command, which is one of the commands supplied with optional 
LAN/9000 products. Do not confuse a node name with a host name, which is a string that 
uniquely identifies an HP-UX system on a UUCP network. Your node and host names can 
be identical, but they are used and set by totally different software. See host name, 
LAN/ 9000 User's Guide, and LAN/ 9000 Node Manager's Guide. 

nonspacing characters 

Characters, such as a diacritical mark or accents, that are used in combination with other 
characters to form composite graphic symbols commonly found in non-English languages. 

open file A file that is currently associated with a file descriptor. 

open file description 

A record of how a process or a group of processes is accessing a file. Each file descriptor 
refers to exactly one open file description, but an open file description can be referred 
to by more than one file descriptor. The file offset, file status flags, and file access 
modes are attributes of an open file description. 

ordinary file A type of HP-UX filecontainingASCII text (eg., program source), binary data (eg., execut¬ 
able code), etc. Ordinary files can be created by the user through I/O redirection, editors, 
or HP-UX commands. 

orphan process 

A child process that is left behind when a parent process terminates for any reason. 
The init process (see init(lM)) inherits (that is, becomes the effective parent of) all 
orphan processes. 

orphaned process group 

A process group in which the parent of every member is either itself a member of the group 
or is not a member of the group's session. 

owner The owner of a file is usually the creator of that file. However, the ownership of a file can 

be changed by the superuser or the current owner with the chown(l) command or the 
chown (2) system call. Thefileowner is able to do whatever he wants with hisfiles, includ¬ 
ing remove them, copy them, move them, change their contents, etc. The owner can also 
change the files' modes. 

parent directory 

The directory one level above a directory in the file hierarchy. All directories except the 
root directory (/) have one (and only one) parent directory. The root directory has no 
parent. See also dot and dot-dot. 

parent process 

Whenever a new process is created by a currently-existing process (via fork(2)), the 
currently existing process is said to be the parent process of the newly created process. 
Every process has exactly one parent process (except the init process, see init), but 
each process can create several new processes with thefork(2) system call. The parent pro¬ 
cess I D of any process is the process ID of its creator. 

parent process ID 

A new process is created by a currently active process. The parent process ID of a pro¬ 
cess is the process ID of its creator for the lifetime of the creator. After the creator's life¬ 
time has ended, the parent process ID is the process ID of init. 

password A string of ASCI I characters used to verify the identity of a user. Passwords can be associ¬ 
ated with users and groups. If a user has a password, it is automatically encrypted and 
entered in the second field of that user's line in the /etc/passwd file. A user can create 
or change his or her own password by using the passwd(l) command. 
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path name A sequence of directory names separated by slashes, and ending with any file name. All file 
names except the last in the sequence must be directories, if a path name begins with a 
slash (/), it is an absolute path name; otherwise, it is a relative path name. A path 
name defines the path to be followed through the hierarchical file system in order to find a 
particular file. 

More precisely, a path name is a null-terminated character string constructed as follows: 

<path-name>::=<file-name>| <path-prefixxfile-name>| / 

<path-prefix>::=<rtprefix>| /<rtprefix> 

<rtprefix>::=<dirname>/ | <rtprefixxdirname>/ 

where <file-name> is a string of one or more characters other than the ASCII slash and 
null, and <dirname> is a string of one or more characters (other than the ASCI I slash and 
null) that names a directory. Fileand directory names can consist of up to 14 characters on 
systems supporting short file names and up to 255 characters on systems supporting long 
file names. 

A slash (/) by itself names the root directory. Two or more slashes in succession 
(////■■■) are treated as a singleslash. 

Unless specifically stated otherwise, the null or zero-length path name is treated as though 
it named a nonexistent file. 

path name resolution 

The process that resolves a path name to a particular file in a file hierarchy. Multiple 
path names can resolve to the same file, depending on whether resolution is sought in abso¬ 
lute or relative terms (see below). Each file name in the path name is located in the direc¬ 
tory specified by its predecessor (for example, in the path name fragment a/b, file b is 
located in directory a). Path name resolution fails if this cannot be accomplished. 

If the path name begins with a slash, the predecessor of the first file name in the path 
name is understood to be the root directory of the process, and the path name is referred 
to as an absolute path name. If the path name does not begin with a slash, the predeces¬ 
sor of the first file name of the path name is understood to be the current working directory 
of the process, and the path name is referred to as a relative path name. A path name 
consisting of a single slash resolves to the root directory of the process. 

path prefix A path name with an optional ending slash that refers to a directory, 
permission bits 

The nine least-significant bits of a file's mode are referred to as file permission bits. 
These bits determine read, write, and execute permissions for the file's owner, the file's 
group, and all others. The bits are divided into three parts: owner, group and other. Each 
part is used with the corresponding file class of processes. The bits are contained in the file 
mode, as described in stat(5). The detailed usage of the file permission bits in access deci¬ 
sions is described in file access permissions. 

See position-independent code. 

An interprocess I/O channel used to pass data between two processes. 11 is commonly used 
by the shell to transfer data from the standard output of one process to the standard input 
of another. On a command line, a pipe is signaled by a vertical bar (|). Output from the 
command to the left of the vertical bar is channeled directly into the standard input of the 
command on the right. 

portable file name character set 

The foil owing set of graphical characters are portable across conforming implementations of 
IEEE Standard P1003.1: 

ABCDEFGHIJKLMNOPQRSTUVWXYZ 
abcdefghijklmnopqrstuvwxyz 
01234567890. 

The last three characters are the dot, underscore and hyphen characters, respectively. The 
hyphen should not be used as the first character of a portable file name. 

position-independent code (PIC) 

Object code that can run unmodified at any virtual address. Position-independent code can 
use PC-relative addressing modes and/or linkage tables. It is most often used in shared 


PIC 

pipe 
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libraries, in which case the linkage tables are initialized by the dynamic loader. Position- 
independent code is generated when the +z or +Z compiler option is specified. 

privileged groups 

A privileged group is a group that has had a setprivgrp (see getprivgrp(2)) operation 
performed on it, giving it access to some system calls otherwise reserved for the superuser. 

See appropriate privileges. 

process An invocation of a program, or the execution of an image (see image). Although all com¬ 
mands and utilities are executed within processes, not all commands or utilities have a 
one-to-one correspondence with processes. Some commands (such as cd) execute within a 
process, but do not create any new processes. Others (such as in the case of Is | wc 
-1) create multiple processes. Several processes can be running the same program, but 
each can be different data and be in different stages of execution. A process can also be 
thought of as an address space and single thread of control that executes within that 
address space and its required system resources. A process is created by another process 
issuing the fork(2) function. The process that issues fork(2) is known as the parent pro¬ 
cess and the new process created by the fork(2) as the child process. 

process 1 See init. 
process group 

Each process in the system is a member of a process group. This grouping permits the 
signaling of related processes. A newly created process joins the process group of its crea¬ 
tor. 

process group ID 

Each process group in the system is uniquely identified during its lifetime by a process 
group ID, a positive integer less than or equal toPlC_MAX. A process group ID cannot 
be reused by the system until the process group lifetime ends. 

process group leader 

A process group leader is a process whose process ID is the same as its process group ID. 

process group lifetime 

A period of time that begins when a process group is created and ends when the last 
remaining process in the group leaves the group, either due to process termination or by 
callingthesetsid(2) or setpgid(2) functions. 

process ID Each active process in the system is uniquely identified during its lifetime by a positive 
integer less than or equal to PID_MAX called a process ID. A process ID cannot be 
reused by the system until after the process lifetime ends. I n addition, if there exists a pro¬ 
cess group whose process group ID is equal to that process ID, the process ID cannot be 
reused by the system until the process group lifetime ends. A process that is not a system 
process shall not have a process ID of 1. 

process lifetime 

After a process is created with a fork(2) function, it is considered active. Its thread of con¬ 
trol and address space exist until it terminates. It then enters an inactive state where 
certain resources may be returned to the system, although some resources, such as the 
process ID are still in use. When another process executes a wait() , wait3() , or 
waitpid() function (see wait(2)) for an inactive process, the remaining resources are 
returned to the system. The last resource to be returned to the system is the process ID. 
At this time, the lifetime of the process ends. 

program A sequence of instructions to the computer in the form of binary code (resulting from the 
compilation and assembly of program source). 

prompt The characters displayed by the shell on the terminal indicating that the system is ready 
for a command. The prompt is usually a dollar sign ($) for ordinary users (% in theC shell) 
and a pound sign (#) for the superuser, but you can redefine it to be any string by setting 
the appropriate shell variable (see sh(l) and related entries). See also secondary prompt. 

quit signal The SIGQUIT signal (see signal (2). The quit signal is generated by typing the character 
defined by the teletype handler as your quit signal. (See stty(l), ioctl (2), and termio(7).) 
The default is the ASCI I FS character (ASCII value 28) generated by typing Ctrl-\. This 
signal usually causes a running program to terminate and generates a file containing the 
"core image" of the terminated process. The core image is useful for debugging purposes. 
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(Some systems do not support core images, and on those systems no such file is generated.) 

radix character 

The character that separates the integer part of a number from the fractional part. For 
example, in American usage, the radix character is a decimal point, while in Europe, a 
comma is used. 

raw disk The name given to a disk for which there exists a character special file that allows direct 
transmission between the disk and the user's read or write buffer. A single read or write 
call results in exactly one I/O call. 

read-only file system 

A characteristic of a file system that prevents file system modifications. 

real group ID 

A positive integer which is assigned to every user on the system. The association of a user 
and his or her real group ID is done in the file /etc/passwd. The modifier "real" is 
used because a user can also have an effective group ID. The real group ID can then be 
mapped to a group name in the file /etc/group, although it need not be. Thus, every 
user is a member of some group (which can be nameless), even if that group has only one 
member. 

Every time a process creates a child process (via fork(2)), that process has a real group ID 
equal to the parent process's real group ID. This is useful for determining file access 
privileges within the process. 

real user ID A positive integer which is assigned to every user on the system. A real user ID is assigned 
to every valid login name in the file /etc/passwd. The modifier "real" is used because 
a user can also have an effective user ID (see effective user ID). 

Every time a process creates a child process (via fork(2)), that process has a real user ID 
equal to the parent process's real user ID. This is useful for determining file access 
privileges within the process. 

regular expression 

A string of zero or more characters that selects text. All the characters contained in the 
string might be literal, meaning that the regular expression matches itself only; or one or 
more of the characters might be a metacharacter, meaning that a single regular expres¬ 
sion could match several literal strings. Regular expressions are most often encountered in 
text editors (such as ed(l), o<(l), or vi (1)), where searches are performed for a specific piece 
of text, or in commands that were created to search for a particular string in a file (most 
notably grep(l)). Regular expressions are also encountered in the shell, especially when 
referring to file names on command lines. 

regular file A type of file that is a randomly accessible sequence of bytes, with no further structure 
imposed by the system. Its size can be extended. A regular file is also called an ordinary 
file. 

relative path name 

A path name that does not begin with a slash (/). It indicates that a file's location is 
given relative to your current working directory, and that the search begins there 
(instead of at the root directory). For example, dirl/file2 searches for the directory 
dirl in your current working directory; then dirl is searched for the file file2. 

root directory 

(1) The highest level directory of the hierarchical file system, from which all other files 
branch. In FIP-UX, the slash (/) character refers to the root directory. The root direc¬ 
tory is the only directory in the file system that is its own parent directory. 

(2) Each process has associated with it a concept of a root directory for the purpose of 
resolving path name searches for those paths beginning with slash (/). A process's root 
directory need not be the root directory of the root file system, and can be changed by the 
chroot(lM) command or chroot(2) system call. Such a directory appears to the process 
involved to be its own parent directory. 

rootvolume The mass storage volume which contains the boot area (which contains the FIP-UX kernel) 
and the root directory of the FIP-UX file system. 
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saved group ID 

Every process has a saved group ID that retai ns the process's effective group ID from the 
last successful e<ec(2) or setresgid() (see setresuid(2)) : or from the last superuser call 
to setgid() (see setuid(2)) or setresuid(2). setgid() permits a process to set its 
effective group ID to this remembered value. Consequently, a process that executes a pro¬ 
gram with the set-group-ID bit set and with a group ID of 5 (for example) can set its 
effective group ID to 5 at any time until the program terminates. See exec(2), setuid(2), 
saved user ID, effective group ID, and set-group-ID bit. The saved group ID is also 
known as the saved set-group-1 D. 

saved process group ID 

Every process has a saved process group ID that retains the process's group ID from the 
last successful e<ec(2). See setpgrp(2), termio(7), and process group ID. 

saved user ID 

Every process has a saved user ID that retains the process's effective user ID from the 
last successful e<ec(2) or setresuid(2), or from the last superuser call to setuid(2). setuid(2) 
permits a process to set its effective user ID to this remembered value. Consequently, a 
process which executes a program with the set-user-1 D bit set and with an owner ID of 5 
(for example) can set its effective user ID to 5 at any time until the program terminates. 
See exec(2), setuid(2), saved group ID, effective user ID, and set-user-ID bit. The 
saved user ID is also known as the saved set-user-ID. 

saved set-group-1 D 

See saved group ID. 

saved set-user-1 D 

See saved user ID. 

SCCS See Source Code Control System. 

Source Code Control System (SCCS) 

A set of HP-UX commands that enables you to store changes to an SCCS file as separate 
"units" (called deltas). These units, each of which contains one or more textual changes to 
the file, can then be applied to or excluded from the SCCS file to obtain different versions of 
the file. The commands that make up SCCS are admin(l), cdc(l), delta(l), get(l), prs(l), 
rmdel (1), sact(l), sccsdiff(l), unget(l), val (1), and what(l). 

SCCSfile An ordinary text fil e that has been modified so the Source Code Control System (SCCS) 
can be used with it. This modification is done automatically by the admin(l) command. 
See also delta. 

secondary prompt 

One or more characters that the shell prints on the display, indicating that more input is 
needed. This prompt is not encountered nearly as frequently as the shell's primary prompt 
(see prompt). When it occurs, it is usually caused by an omitted right quote on a string 
(which confuses the shell), or when you enter a shell programming language control-flow 
construct (such as a for construct) from the command line. By default, the shell's secon¬ 
dary prompt is the greater-than sign (>), but you can re-define it by setting the shell vari- 
ablePS2 appropriately in your .profile file. (TheC shell has no secondary prompt.) 

select code On Series 700 systems, part of an address used for devices. Multiple peripherals con¬ 
nected to the same interface card share the same select code. On Series 700 systems, 
select code consists of the bus and slot numbers for a device, both of which are determined 
by the particular I/O slot in which the I/O card resides. All functions on a multifunction 
card share the same select code. 


semaphore identifier (semid) 

A unique positive integer created by a semgdt(2) system call. Each semid has a set of 
semaphores and a data structure associated with it. The data structure is referred to as 
semid_ds and contains the foil owing members: 


struct ipc_perm sem__perm; 
ushort sem_nsems; 
time_t s em otime; 
time_t s em ctime; 


/* operation permission */ 

/* number of sems in set */ 

/* last operation time */ 

/* last change time */ 

/* Times measured in secs since */ 
/* 00:00:00 GMT, Jan. 1 , 1970 */ 
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Semaphore identifiers can be created using ftok(3C). 

semjerm is a ipc_perm structure that specifies the semaphore operation permission (see 
below). This structure includes the foil owing members: 


ushort 

cuid; 

/* 

creator user id */ 

ushort 

cgid; 

/* 

creator group id */ 

ushort 

uid; 

/* 

user id */ 

ushort 

gid; 

/* 

group id */ 

ushort 

mode; 

/* 

r/a permission */ 


The value of sem_nsems is equal to the number of semaphores in the set. Each sema¬ 
phore in the set is referenced by a positive integer referred to as a sem_num. sem_num 
values run sequentially from 0 to the value of sem_nsems minus 1. sem_otime is the 
time of the last semop(2) operation, and sem_ctime is the time of the last semctl (2) 
operation that changed a member of the above structure. 

A semaphore is a data structure that contains thefollowing members: 

ushort semval; /* semaphore value */ 

short sempid; /* pid of last operation */ 

ushort semncnt; /* # awaiting semval > cval */ 

ushort semzcnt; /* # awaiting semval = 0 */ 

semval is a nonnegative integer, sempid is equal to the process ID of the last process 
that performed a semaphore operation on this semaphore, semncnt is a count of the 
number of processes that are currently suspended awaiting this semaphore's semval to 
become greater than its current value, semzcnt is a count of the number of processes 
that are currently suspended awaitingthis semaphore's semval to become zero. 

semaphore operation permissions 

In the semop(2) and semctl (2) system call descriptions, the permission required for an 
operation is indicated for each operation. Whether a particular process has these permis¬ 
sions for an object isdetermined by theobject's permission mode bits as follows: 

00400 Read by user 

00200 Alter by user 

00060 Read, Alter by group 

00006 Read, Alter by others 

Read and Alter permissions on a semid are granted to a process if one or more of the fol¬ 
lowing are true: 

• The process's effective user ID is superuser. 

• The process's effective user ID matches sem_perm. [cjuid in the data structure 
associated with semid and the appropriate bit of the "user" portion (0600) of 
sem_perm.mode is set. 

• The process's effective user ID does not match sem_perm. [cjuid and the 
appropriate bit of the "group" portion (060) of sem_perm. mode is set. 

• The process's effective user ID does not match sem_perm. [cjuid and the 
process's effective group ID does not match sem_perm. [cjgid and neither of 
sem_perm. [cjgid is in the process's group access list and the appropriate bit of 
the "other" portion (06) of sem_perm. mode is set. 

Otherwise, the corresponding permissions are denied. 

semid See semaphore identifier. 

session Each process group is a member of a session. A process is considered to be a member of the 

session of which its process group is a member. A newly created process joins the session of 
its creator. A process can alter its session membership (see setsid(2)). A session can have 
multiple process groups (see setpgid(2)). 

session leader 

A process that has created a session (see setsid(2)). 

session lifetime 

The period between when a session is created and the end of the lifetime of all process 
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groups that remain as members of the session. 

set-group-1 D bit 

A single bit in the mode of every file in the file system. If a file is executed whose set- 

group-ID bit is set, the effective group ID of the process which executed the file is set 

equal to the real group ID of the owner of the file. See also group. 

set-user-ID bit 

A single bit in the mode of every file in the file system. If a file is executed whose set- 

user-ID bit is set, the effective user ID of the process that executed the file is set equal 

to the real user ID of the owner of the file. 

shared library 

An executable file that can be shared between several different programs. Code from a 
shared library is not linked into the program by Id(1), but is instead mapped into the pro¬ 
cess' address space at run time by the dynamic loader. Shared libraries must contain 
position-independent code, and are created by Id(1). They typically have the file name 
suffix .si. 


shared memory identifier (shmid) 

A unique positive integer created by a shmget(2) system call. Each shmid has a segment 
of memory (referred to as a shared memory segment) and a data structure associated with 
it. The data structure is referred to as shmid_ds and containsthefollowing members: 


struct 

ipc_perm shm_perm; 

/* 

operation permission 

struct */ 

int 

shm_segsz; 

/* 

size of segment */ 


ushort 

shm_cpid; 

/* 

creator pid */ 


ushort 

shm_lpid; 

/* 

pid of last operation 

*/ 

short 

shm_nattch; 

/* 

number of current attaches */ 

time_t 

shm_atime; 

/* 

last attach time */ 


time_t 

shm_dtime; 

/* 

last detach time */ 


time_t 

shm_ctime; 

/* 

last change time */ 




/* 

Times measured in secs since */ 



/* 

00:00:00 GMT, Jan. 1, 

1970 */ 


Shared memory identifiers can be created using ftok(3C). 

shm_jperm is a ipc_perm structure that specifies the permission for a shmop(2) or 
shmctl (2) operation (see below). Thisstructure includesthefollowing members: 


ushort 

cuid; 

/* 

ushort 

cgid; 

/* 

ushort 

uid; 

/* 

ushort 

gid; 

/* 

ushort 

mode; 

/* 


creator user id */ 
creator group id */ 
user id */ 
group id */ 
r/w permission */ 


shm_segsz specifies the size of the shared memory segment. shm_cpid is the process 
id of the process that created the shared memory identifier. shm_lpid is the process id of 
the last process that performed a shmop(2) operation. shm_nattch is the number of 
processes that currently have this segment attached. shm_atime is the time of the last 
shmat operation, shm_dtime is the time of the last shmdt operation, and 
shm_ctime is the time of the last shmctl (2) operation that changed one of the members of 
the above structure. 


shared memory operation permissions 

In the shmop(2) and shmctl(2) system call descriptions, the permission required for an 
operation is indicated for each operation. Whether a particular process has the permission 
to perform a shmop(2) or shmctl (2) operation on an object is determined by the object's per¬ 
mission mode bits as follows: 


00400 Read by user 

00200 Write by user 

00060 Read, Write by group 

00006 Read, Write by others 

Read and Write permissions for a shmop(2) or shmctl (2) operation on a shared memory 
identifier (shmid) are granted to a process if one or more of thefollowing are true: 
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• The process's effective user ID is superuser. 

• The process's effective user ID matches shm_perm. [c]uid in the data structure 
associated with the shmid and the appropriate bit of the "user" portion (0600) of 
shm_perm.mode is set. 

• The process's effective user ID does not match shmjem. [c]uid and either the 
process's effective group ID matches shm_perm. [cjgid or one of 
shm_perm. [c]gid is in the process's group access list and the appropriate bit of 
the "group" portion (060) of shm_perm. mode is set. 

• The process's effective user ID does not match shm_perm. [c]uid and the 
process's effective group ID does not match shm_perm. [c]gid and neither of 
shm_perm. [c]gid is in the process's group access list and the appropriate bit of 
the "other" portion (06) of shm_perm. mode is set. 

Otherwise, the corresponding permissions are denied. 

shell A user interface to the HP-UX operating system. A shell often functions as both a com¬ 

mand interpreter and an interpretive programming language. A shell is automatically 
invoked for every user who logs in. See sh(l) and its related manual entries plus the 
tutorials supplied with your system for details. 

shell program 

See shell script. 

shell script A sequence of shell commands and shell programming language constructs stored in a file 
and invoked as a user command (program). No compilation is needed prior to execution 
because the shell recognizes the commands and constructs that make up the shell program¬ 
ming language. A shell script is often called a shell program or a command file. See the 
Shells User Guide. 

shmid See shared memory identifier. 

signal A software interrupt sent to a process, informing it of special situationsor events. Also, the 

event itself. See signal (2). 

single-user state 

A condition of the HP-UX operating system in which the system console provides the only 
communication mechanism between the system and its user. By convention, single-user 
state is usually specified by init(lM) as run-level S or s. Do not confuse single-user state, 
in which the software is limiting a multiuser system to a single-user communication, with a 
single-user system, which can never communicate with more than one fixed terminal. See 
also multiuser state. 

slash The literal character /. A path name consisting of a single slash resolves to the root 

directory of the process. See also path name resolution. 

solidus See slash. 

source code The fundamental high-level information (program) written in the syntax of a specified com¬ 
puter language. Object (machine-language) code is derived from source code. When deal¬ 
ing with an HP-UX shell command language, source code is input to the command 
language interpreter. The term shell script is synonymous with this meaning. When 
dealing with the C Language, source code is input to the cc(l) command. Source code 
can also refer to a collection of sources meeting any of the above conditions. 

special file A file associated with an I/O device. Often called a device file. Special files are read and 
written the same as ordinary files, but requests to read or write result in activation of the 
associated device. Due to convention and consistency, these files should always reside in 
the /dev directory. Seealsofile. 

special processes 

Processes with certain (small) process I Ds are special. On a typical system, the I Ds of 0, 1, 
and 2 are assigned as follows: Process 0 is the scheduler. Process 1 is the initialization pro¬ 
cess init, and is the ancestor of every other process in the system. It is used to control 
the process structure. On paging systems with virtual memory, process 2 is the paging 
daemon. 
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SS/80 See CS/80. 

standard error 

The destination of error and special messages from a program, intended to be used for diag¬ 
nostic messages. The standard error output is often called stderr, and is automatically 
opened for writing on file descriptor 2 for every command invoked. By default, the user's 
terminal is the destination of all data written to stderr, but it can be redirected elsewhere. 
Unlike standard input and standard output, which are never used for data transfer in the 
"wrong" direction, standard error is occasionally read. This is not recommended practice, 
since I/O redirection is likely to break a program doing this. 

standard input 

The source of input data for a program. The standard input file is often called stdin, and is 
automatically opened for reading on file descriptor 0 for every command invoked. By 
default, the user's terminal is the source of all data read from stdin, but it can be 
redirected from another source. 

standard output 

The destination of output data from a program. The standard output file is often called 
stdout, and is automatically opened for writing on file descriptor 1 for every command 
invoked. By default, the user's terminal is the destination of all data written to stdout, but 
it can be redirected elsewhere. 

See standard error. 

See standard input. 

See standard output. 

A term most often used in conjunction with the standard I/O library routines documented 
in Section 3 of this manual. A stream is simply a file pointer (declared as FILE 
♦stream) returned by the fopen(3S) library routines. It may or may not have buffering 
associated with it (by default, buffering is assigned, but this can be modified with 
setbuf (3S)). 

A single bit in the mode of every file in the file system. If set on a regular file, the con¬ 
tents of the file stay permanently in memory instead of being swapped back out to disk 
when the file has finished executing. Only superuser can set the sticky bit on a regular 
file. The sticky bit is read each time the file is executed (via e<ec(2)). 

If set on a directory, the files in that directory can be removed or renamed only by the 
owner of the file, the owner of the directory containing the file, or superuser. See also 
chmod(2), rename(2), rmdir(2), and unlink®. 

subdirectory A directory that is one or more levels lower in the file system hierarchy than a given direc¬ 
tory. Sometimes called a subordinate directory. 

subordinate directory 

See subdirectory. 

Subset 1980 See CS/80. 

superblock A block on each file system's mass storage medium which describes the file system. The 
contents of the superblock vary between implementations. Refer to the System Adminis¬ 
trator manuals supplied with your system, and the appropriatefs(4) entry for details. 

superuser The HP-UX system administrator. This user has access to all files, and can perform 
privileged operations, superuser has a real user ID and effective user ID of 0, and, by 
convention, the user name of root. 

superior directory 

See parent directory. 

supplementary group ID 

A process has up to NGROUPS_MAX supplementary group IDs used in determining file 
access permissions, in addition to the effective group ID. The supplementary group IDs of 
a process are set to the supplementary group I Ds of the parent process when the process is 
created. 

symbolic link A type of file that indirectly refers to a path name. See symlink(4). 


stderr 

stdin 

stdout 

stream 


sticky bit 
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system The HP-UX operating system. See also kernel, 

system asynchronous I/O 

A method of performing I/O whereby a process informs a driver or subsystem that it wants 
to know when data has arrived or when it is possible to perform a write request. The 
driver or subsystem maintains a set of buffers through which the process performs I/O. See 
ioctl (2), read(2), select(2), and write(2) for more information. 

system call An HP-UX operating system kernel function available to the user through a high-level 
language (such as FORTRAN, Pascal, or C). Also called an "intrinsic" or a "system intrin¬ 
sic." The available system calls are documented in Section 2 of the HP-UX Reference 
Manual. 

system console 

A keyboard and display (or terminal) given a unique status by HP-UX and associated with 
the special file /dev/console . All boot ROM error messages, HP-UX system error mes¬ 
sages, and certain system status messages are sent to the system console. Under certain 
conditions (such as the single-user state), the system console provides the only mechanism 
for communicating with HP-UX. See the System Administrator manuals and user guides 
provided with your system for details on configuration and use of the system console. 

system process 

A system process is a process that runs on behalf of the system. It may have special 
implementation-defined characteristics. 

terminal A character special file that obeys the specifications of termio(7). 

terminal affiliation 

The process by which a process group leader establishes an association between itself and a 
particular terminal. A terminal becomes affiliated with a process group leader (and subse¬ 
quently all processes created by the process group leader, see terminal group) whenever 
the process group leader executes (either directly or indirectly) an open(2) or creat(2) sys¬ 
tem call to open a terminal. Then, if the process which is executing open(2) or creat(2) is a 
process group leader, and if that process group leader is not yet affiliated with a terminal, 
and if the terminal being opened is not yet affiliated with a process group, the affiliation is 
established (however, see open(2) description of 0_N0CTTY). 

An affiliated terminal keeps track of its process group affiliation by storing the process 
group's process group ID in an internal structure. 

Two benefits are realized by terminal affiliation. First, all signals sent from the terminal 
are sent to all processes in the terminal group. Second, all processes in the terminal group 
can perform I/O to/from the generic terminal driver /dev/tty, which automatically 
selects the affiliated terminal. 

Terminal affiliation is broken with a terminal group when the process group leader ter¬ 
minates, after which the hangup signal is sent to all processes remaining in the process 
group. Also, if a process (which is not a process group leader) in the terminal group 
becomes a process group leader via the setpgrp(2) system call, its terminal affiliation is bro¬ 
ken. 

See process group, process group leader, terminal group, and setpgrp(2). 

terminal device 

See terminal. 

A file that contains characters organized into one or more lines. The lines cannot contain 
NUL characters, and none can exceed LINE__MAX bytes in length including the terminat¬ 
ing newline character. Although neither the kernel nor the C language implementation 
distinguishes between text files and binary files (see ANSI C Standard X3-159-19xx), many 
utilities behave predictably only when operating on text files. 

Originally, an abbreviation for teletypewriter; now, generally, a terminal. 

The conversion of a lowercase character to its uppercase representation. 

Each system user is identified by an integer known as a user ID, which is in the range of 
zero to UID MAX, inclusive. Depending on how the user is identified with a process, a 
user ID value is referred to as a real user ID, an effective user ID, or a saved user ID. 


text file 


tty 

upshifting 
user ID 
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UTC See Epoch. 

utility An executable file, which might contain executable object code (that is, a program), or a 

list of commands to execute in a given order (that is, a shell script). You can write your 
own utilities, either as executable programs or shell scripts (which are written in the shell 
programming language). 

volume number 

Part of an address used for devices. A number whose meaning is software- and device¬ 
dependent, but which is often used to specify a particular volume on a multivolume disk 
drive. See the System Administrator manuals supplied with your system for details. 

whitespace One or more characters which, when displayed, cause a movement of the cursor or print 
head, but do not result in the display of any visible graphic. The whitespace characters in 
the ASCII code set are space, tab, newline, form feed, carriage return, and vertical tab. A 
particular command or routine might interpret some, but not necessarily all, whitespace 
characters as delimiting fields, words, or command options. 

working directory 

Each process has associated with it the concept of a current working directory. For a shell, 
this appears as the directory in which you currently "reside". This is the directory in which 
relative path name (i.e., a path name that does not begin with /) searches begin. It is 
sometimes referred to as the current directory, or the current working directory. 

zombie process 

The name given to a process which terminates for any reason, but whose parent process 
has not yet waited for it to terminate (via wait(2)). The process which terminated contin¬ 
ues to occupy a slot in the process table until its parent process waits for it. Because it has 
terminated, however, there is no other space allocated to it either in user or kernel space. 
It is therefore a relatively harmless occurrence which will rectify itself the next time its 
parent process waits. The ps(l) command lists zombie processes as defunct. 
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Description Entry Name(Section) 

(CUE), HP Character-Terminal User Environment.cue(l) 

(named pipe) special files, make FIFO .mkfifo(l) 

(NFS) mount to remote file system, perform Network FileSystem .vhe_u_mnt(lM) 

(UNIX) system, call another; terminal emulator .cu(l) 

.glossary(9) 

.glossary (9) 

.forward file .sendmail(lM) 

.netrc - login information for rexec() and ftp .netrc(4) 

. o.glossary (9) 

.profile file.login(l) 

.profile - shell script to set up user's environment at login .profile(4) 

. rhosts file.login(l) 

. rhosts - security files authorizing access by remote hosts and users on local host.hosts.equiv(4) 

.so'sfrom nroff input, eliminate.soelim(l) 

/etc files or NIS maps: creating NIS+tables.nisaddent(lM) 

/etc/ioconfig, maintain consistency with kernel data structures.ioinit(lM) 

/etc/issue identification file .issue(4) 

/etc/ivmpvg - LVM physical volume group information file .Ivmpvg(4) 

/etc/mnttab, establish mount table.setmnt(lM) 

/etc/termcap access routines, emulate.termcap(3X) 

/etc/utmp, get login name of user from.getlogin(3C) 

/sbin/set j?arms special initialization script.hostname(l) 

16-bit characters, tools to process .nl_tools_16(3X) 

3179G/3192G, 3270, 3777terminal emulator, IBM .sna(l) 

3270, 3777terminal emulator, IBM 3179G/3192G.sna(l) 

3777terminal emulator, IBM 3179G/3192G, 3270.sna(l) 

<curses. h>- definition for screen handling and optimisation functions .curses(5) 

<}nath. h>- math functions and constants .math(5) 

<regexp.h>- regular expression and pattern matching notation definitions.regexp(5) 

<tem.h>- terminal capabilities.term(5) 

<sinctri .h>-definition for unctri () .unctrl(5) 

<pwd.h> password file format.passwd(4) 

a region of window, copy .copywin(3X) 

a.out - assembler and link editor output format .a.out(4) 

a. out.glossary (9) 

a64l() - convert base-64valueto long integer ASCII string.a64l(3C) 

abbreviation of function keys, enable/disable.key pad (3X) 

abort a per-process timer .rmtimer(3C) 

abort () - generate an IOT fault .abort(3C) 

abs (), labs () - return integer absolute value.abs(3C) 

absolute debugger.adb(l) 

absolute path name .glossary(9) 

absolute system time, add a specific time interval to the current .get_expiration_time(3T) 

absolute value functions .fabs(3M) 

absolute value, return integer .abs(3C) 

accept - allow LP printer queuing requests.accept(lM) 

accept () - accept connection on a socket .accept(2) 

access and manage the pathalias database .uupath(l) 

access and modification times, set for files.utimes(2) 

access control list (ACL) information, get.getacl(2) 

access control list (ACL) information, set .setacl(2) 

access control list (ACL) structure, convert to string form.acltostr(3C) 

access control list (ACL) structure, convert string to.strtoacl(3C) 

access control list (ACL), change owner and/or group in.chownacl(3C) 

access control list (ACL), copy to another file.cpacl(BC) 

access control list; add, modify, or delete entry .setacl entry (3C) 
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access control lists (ACLs) of files, list .Isacl(l) 

access control lists, introduction to.acl(5) 

access control lists, view or modify.swacl(lM) 

access control lists; add, modify, delete, copy, or summarize.chacl(l) 

access device driver, SCSI direct .scsi_disk(7) 

access device driver, SCSI sequential .scsi_tape(7) 

access exported filesystem information.exportent(3N) 

access functions, NIS+database.nis_db(3N) 

access.glossary (9) 

access groups.glossary(9) 

access information, network I/O card .Ian (7) 

access list, get group.getgroups(2) 

access list, initializegroup.initgroups(3C) 

access list, set group .setgroups(2) 

access mode.glossary(9) 

access or build a binary search tree .tsearch(3C) 

access path of physical volume in LVM volume group, change.pvchange(lM) 

access permissions mode mask for file-creation, set .umask(l) 

access permissions, change file mode.chmod(l) 

access permissions, change file mode.chmod(2) 

access privileges for group, list .getprivgrp(l) 

access privileges, associate group with .setprivgrp(lM) 

access protected password database entry.getprpwent(3) 

access protections, modify memory mapping.mprotect(2) 

access rights to a file, get a user's effective .getaccess(2) 

access rights to file(s), list.getaccess(l) 

access rights: change on an NIS+object .nischmod(l) 

Access software, Data Communications and Terminal Controller Device File.ddfa(7) 

access the terminfo database.tput(l) 

access times, set or update file.utime(2) 

access to/etc/passwd file, control .lckpwdf(3C) 

accessutmp() orwtmpO file.getut(3C) 

accessutmpx() orwtmpO file.getutx(3C) 

access uucp and uux transactions summary log .uucp(l) 

access () - determine accessibility of a file .access(2) 

access, group, format of privileged values.privgrp(4) 

access, modification, and/or change times of a file, update.touch(l) 

access, open, or close a directory and associated directory stream .directory(3C) 

accessibility of a file, determine.access(2) 

account, authentication, session and password management PAM modules for UNIX .pam_unix(5) 

account, perform validation procedures for PAM account .pam_acct_mgmt(3) 

accounting (tacct) file, print any total .acctsh(lM) 

accounting data and command usage summary, accumulate.acctsh(lM) 

accounting data of VxFS file system, disk usage by user ID .vxdiskusg(lM) 

accounting data, disk usage by user ID .diskusg(lM) 

accounting files, process, convert to ASCII text format .acctprc(lM) 

accounting files, process, summarize by user ID and name.acctprc(lM) 

accounting files, search and print .acctcom(lM) 

accounting files, total, merge or add .acctmerg(lM) 

accounting records, manipulate.fwtmp(lM) 

accounting records, per-process, command summary from.acctcms(lM) 

accounting summary files, create periodic.acctsh(lM) 

accounting: acctcms - command summary from per-process accounting records .acctcms(lM) 

accounting: acctconi - convert login/logoff records to per-session accounting records .acctcon(lM) 

accounting: acctcon2 - convert per-session records to total accounting records .acctcon(lM) 

accounting: acctdisk - create disk usage accounting records .acct(lM) 

accounting: acctdusg - compute disk usage by login name.acct(lM) 

accounting: acctmerg - merge or add total accounting files.acctmerg(lM) 

accounting: accton - define kernel process accounting output fileor disableaccounting .acct(lM) 

accounting: acctprci - convert process accounting files to ASCII text format .acctprc(lM) 

accounting: acctprc2 - summarize process accounting files created by acctprci .acctprc(lM) 
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accounting: acctwtmp - writeutmp record and reason for writing.acct(lM) 

accounting: chargefee - charge fee to user based on system usage .acctsh(lM) 

accounting: check size of process accounting file.acctsh(lM) 

accounting: ckpacct - check size of process accounting file.acctsh(lM) 

accounting: daily accounting shell procedure.runacct(lM) 

accounting: dodisk - perform disk accounting.acctsh(lM) 

accounting: enable or disable process accounting.acct(2) 

accounting: lastiogin - show last login date for each user .acctsh(lM) 

accounting: monacct - create periodic accounting summary files.acctsh(lM) 

accounting: nuiiadm - create empty file owned by adm with mode 664.acctsh(lM) 

accounting: per-process accounting file format .acct(4) 

accounting: perform disk accounting.acctsh(lM) 

accounting: prctmp - print session record file created by acctconi .acctsh(lM) 

accounting: prdaily - print daily accounting report.acctsh(lM) 

accounting: prtacct - print any total accounting (tacct) file.acctsh(lM) 

accounting: runacct - accumulate accounting data and command usage summary.acctsh(lM) 

accounting: shell procedures for system accounting .acctsh(lM) 

accounting: shutacct - turn off accounting for system shutdown.acctsh(lM) 

accounting: startup - start accounting process at system startup .acctsh(lM) 

accounting: turnacct - turn on or turn off process accounting.acctsh(lM) 

accounting: user accounting file entry format.utmp(4) 

acct - per-process accounting file format.acct(4) 

acct () - enable or disable process accounting.acct(2) 

acctcms - command summary from per-process accounting records.acctcms(lM) 

acctcom - search and print process accounting files.acctcom(lM) 

acctconi - convert login/logoff records to per-session accounting records.acctconi 1M) 

acctconi - print session record file created by .acctsh(lM) 

acctcon2 - convert per-session records to total accounting records.acctconi 1M) 

acct disk - create disk usage accounting records .acct(lM) 

acctdusg - compute disk usage by login name.acct(lM) 

acctmerg - merge or add total accounting files .acctmerg(lM) 

accton - define kernel process accounting output file or disable accounting.acct(lM) 

acctprc - convert process accounting files to ASCI I text format .acctprc(lM) 

acctprci - convert process accounting files to ASCI I text format .acctprc(lM) 

acctprc2 - summarize process accounting files created by acctprci.acctprc(lM) 

acctwtmp - writeutmp record and reason for writing .acct(lM) 

ACL, view or modify .swacl(lM) 

acientrystart () - convert string to access control list (ACL) structure.strtoacl(3C) 

ACLs.see access control lists 

acitostr () - convert access control list (ACL) structure to string form.acltostr(3C) 

acos() - arccosine function .acos(3M) 

acosd () - arccosine function (degrees) .acosd(3M) 

acosdf () - arccosine function (float, degrees) .acosd(3M) 

acosf () - arccosine function (float) .acos(3M) 

acosh() - inverse hyperbolic cosine function.acosh(3M) 

active controllers on HP-IB, change .hpib_pass_ctl(3l) 

active processes, kill (terminate) all.killall(lM) 

activity on specified HP-IB bus, stop .hpib_abort(3l) 

activity reporter, system .sar(lM) 

activity, print current SCCS file editing.sact(l) 

activity, system, daily report package.sal(lM) 

adb - absolute debugger .adb(l) 

add a complex character and rendition to a window .add_wch(3X) 

add a new group to the system.groupadd(lM) 

add a printer for use with tsm .tsm.lpadmin(lM) 

add a single-byte character and rendition to a window and advance the cursor .addch(3X) 

add a string of multi-byte characters without rendition to a window and advance cursor .addnstr(3X) 

add a user login on the system .useradd(lM) 

add a wide-character stringto a window and advance the cursor .addnwstr(3X) 

add an array of complex characters and renditions to a window.add_wchnstr(3X) 

add length limited string of single-byte characters and renditions to a window.addchnstr(3X) 
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add line number in front of each line in a file.nl(l) 

add new commands to system.install(lM) 

add or merge total accounting files .acctmerg(lM) 

add physical volumes to extend an LVM volume group .vgextend(lM) 

add string of single-byte characters and renditions to a window.addchstr(3X) 

add swap device for interleaved paging and swapping.swapon(2) 

add valueto environment.putenv(3C) 

add, delete, updatea kernel module.kminstall(lM) 

add, modify, delete, copy, or summarize file access control lists (ACLs) .chacl(l) 

add, modify, or delete access control list entry .setaclentry(3C) 

addch () - add a single-byte character and rendition to a window and advance the cursor.addch(3X) 

addchnstr () -addlength limited string of single-bytecharacters and renditions to a window ... addchnstr(3X) 

addchstr () - add string of single-bytecharacters and renditions to a window.addchstr(3X) 

addexportent () - access exported filesystem information .exportent(3N) 

additional cursor and window coordinates, get .getbegyx(3X) 

additional severities, define.addsev(3C) 

addmntent () - add entry to open filesystem description file.getmntent(3X) 

addnstr () - add a string of multi-byte characters without rendition to a window and 

advance cursor.addnstr(3X) 

addnwstr () - add a wide-character string to a wi ndow and advance the cursor.addnwstr(3X) 

address.glossary(9) 

address manipulation routines, Internet .inet(3N) 

address mapping, physical memory .iomap(7) 

address of connected peer, get .getpeername(2) 

address resolution display and control .arp(lM) 

address resolution protocol .arp(7P) 

address router, electronic.pathalias(l) 

address space .glossary(9) 

address string conversion routines, network station.net_aton(3C) 

address to a socket, bind.bind(2) 

address, get socket .getsockname(2) 

addresses - first locations beyond allocated program regions.end(3C) 

addsev() - define additional severities.addsev(3C) 

addstr () - add a string of multi-byte characters without rendition to a window and 

advance cursor.addnstr(3X) 

addwstr () - add a wide-character string to a wi ndow and advance the cursor.addnwstr(3X) 

add wch () - add a complex character and rendition to a window .add_wch(3X) 

add wchnstr () - add an array of complex characters and renditions to a wi ndow.add_wchnstr(3X) 

add wchstr () - add an array of complex characters and renditions to a wi ndow.add_wchnstr(3X) 

adjtime () - correct thetimeto synchronize the system clock .adjtime(2) 

adjust - simpletext formatter .adjust(l) 

adjustment table, time zone, for date and ctime .tztab(4) 

admin - create and administer SCCS files.admin(l) 

administer and create SCCS files.admin(l) 

administer LicensePower/iFOR licensing.i4admin(lM) 

administer NIS+groups .nisgrpadm(l) 

administer NIS+tables.nistbladm(l) 

administration command for filesystem.fsadm(lM) 

administration command for HFS filesystem.fsadm_hfs(lM) 

administration commands, filesystem configuration and binary files.fs_wrapper(5) 

administration file owned by adm with mode 664, create empty .acctsh(lM) 

administration functions, NIS+log.nis_ping(3N) 

administration manager, system, menu-driven .sam(lM) 

administration, kernel module .kmadmin(lM) 

administration, local area network .lanadmin(lM) 

administration: STREAMS Administrative Driver .sad(7) 

administrator, system .passwd(l) 

advance () - advance pointer to next 8- or 16-bit character.nl_tools_16(3X) 

advance () - regular expression substring comparison routines .regexp(3X) 

AdvanceLink server, BasicSerial and FHP .pcserver(lM) 

advances a job to the top of a queue.pdpromote(l) 
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advise system of process's expected paging behavior.madvise(2) 

affiliation .glossary(9) 

affirmative responses, repetitively.yes(l) 

aio () - POSIX asynchronous I/O facility .aio(5) 

aio cancel () - cancel asynchronous I/O operation .aio_cancel(2) 

aio error () - return error status of asynchronous I/O operation .aio_error(2) 

aio fsync () - bring asynchronous I/O operations to synchronized state.aio_fsync(2) 

aio read () - start asynchronous read operation .aio_read(2) 

aio return () - return asynchronous I/O operation status .aio_return(2) 

aio suspend () - suspend for asynchronous I/O completion .aio_suspend(2) 

aio suspend () - wait for asynchronous I/O completion .aio_suspend(2) 

aio write () - start asynchronous write operation .aio_write(2) 

alarm clock, set a process's .alarm(2) 

alarm () - set a process’s alarm clock .alarm(2) 

alias database.elm(l) 

aliasfile, createsendmaiI.sendmail(lM) 

alias - substitutecommand and/or file name .sh-posix(l) 

alias - substitutecommand and/or filename.csh(l) 

alias - substitutecommand and/or filename .ksh(l) 

aliastext file.elm(l) 

alias: install new elm aliasesfor user or system .newalias(l) 

aliases - aliasesfiIefor sendmail .aliases(5) 

aliasesand paths, locatea program file including.which(l) 

aliasesfilefor sendmail .aliases(5) 

aliases file, for mail, rebuild the database.newaliases(lM) 

aliases, elm user and system, verify and display.elmalias(l) 

aliases, print system-wide sendmai I .praliases(l) 

all users over a network, write to.rwall(lM) 

alloc - show dynamic memory usage.csh(l) 

aiioca () - allocate space from the stack .malloc(3C) 

allocate a per-process ti mer.mktimer(3C) 

allocatedata and stack space then lock process into memory.datalock(3C) 

allocate library structure for transport function argument structures (X/OPEN TLI-XTI).t_alloc(3) 

allocate reserved space for a disk storage file.prealloc(l) 

allocated physical extents, move from one LVM physical volume to other physical volumes .pvmove(lM) 

allocated program regions, first locations beyond .end(3C) 

allocation space of object files, print section sizes and.size(l) 

allocation, change data segment space.brk(2) 

allocator for main memory.malloc(3C) 

allow interface to enable SRQ lineon HP-IB .hpib_rqst_srvce(3l) 

allow signalsto interrupt functions.siginterrupt(2) 

allowed login shells, list of .shells(4) 

alphasort () - sort a directory pointer array.scandir(3C) 

alter contents of and copy a (tape) file .dd(l) 

alter priority of running processes .renice(l) 

alter selected characters.tr(l) 

alternate stack context, set/get signal alternate stack context .sigaltstack(2) 

an array of complex characters and renditions to a window, add.add_wchnstr(3X) 

analysisinformation, print LP spooler performance.Ipana(lM) 

ancillary agent for inbound zone transfer.named-xfer(lM) 

anonymous memory region, initializesemaphore in mapped fileor .msem_init(2) 

anonymous region, remove semaphore in mapped fileor .msem_remove(2) 

another system over LAN, log in on.vt(l) 

answer - phone message transcription system.answer(l) 

APIs, PAM Service Module APIs.pam_sm(3) 

append characters to obtain text line of specified length .newform(l) 

application, explicit locking of streams within a multi-thread.flockfile(3S) 

application, header fi I e for future applications.portal (5) 

applyinga diff filetoan original .patch(l) 

appropriate privileges.glossary(9) 

appropriate privileges, associate group with certain .setprivgrp(lM) 
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ar - archive and library maintainer for portable archives.ar(l) 

ar - common archive file format.ar(4) 

arbitrary-precision arithmetic language.bc(l) 

arccosine functions (degrees).acosd(3M) 

arccosine functions.acos(3M) 

archive and library maintainer for portable archives.ar(l) 

archive exchange, portable .pax(l) 

archive file format, common .ar(4) 

archive format, cpio.cpio(4) 

archive format, tar tape .tar(4) 

archive .glossary(9) 

archive member access for ELF files .elf_rand(3E) 

archive member header for ELF files, retrieve.elf_getarhdr(3E) 

archive package, make an .shar(l) 

archive symbol tablefor ELF files, retrieve.elf_getarsym(3E) 

archive symbol table, regenerate.ranlib(l) 

archive the file system .backup(lM) 

archiver for tape files.tar(l) 

archiver, tape file.tar(l) 

archives, copy file archives in and out.cpio(l) 

arcsine functions (degrees) .asind(3M) 

arcsine functions .asin(3M) 

arctangent functions (degrees) .atand(3M) 

arctangent functions.atan(3M) 

arctangent-and-quadrant functions (degrees) .atan2d(3M) 

arctangent-and-quadrant functions .atan2(3M) 

argument list(s), large, construct and execute command .xargs(l) 

argument list, print formatted output of a varargs.vprintf(3S) 

argument lists, variable, macros for handling.stdarg(5) 

argument lists, variable, macros for handling.varargs(5) 

argument vector, get option letter from.getopt(3C) 

argument, varargs, formatted input conversion to a .vscanf(3S) 

arguments, echo (print).echo(l) 

arguments, evaluateasan expression .expr(l) 

arguments, print formatted .printf(l) 

arguments, too many (error); construct argument list(s) and execute command .xargs(l) 

arithmetic desk calculator.dc(l) 

arithmetic language, arbitrary-precision .bc(l) 

arm a per-process timer, relatively .reltimer(3C) 

arp - address resolution display and control .arp(lM) 

arp - address resolution protocol .arp(7P) 

array element, convert floating-point number to string or string.ecvt(3C) 

array of complex characters and renditions, input from a window.in_wchnstr(3X) 

array of single-bytecharacters and renditions, input from a window .inchnstr(3X) 

array of wide characters and function key codes, get from a terminal.getn_wstr(3X) 

array, sort a directory pointer .scandir(3C) 

arrayinfo -describe disk array characteristics .arrayinfo(lM) 

arrayscan - search system for disk arrays.arrayscan(lM) 

arraytab - disk array configuration table.arraytab(4) 

as - assembler (Precision Architecture).as(l) 

ASA carriage control characters, interpret .asa(l) 

asa - interpret ASA carriage control characters.asa(l) 

ASCII format, dump iconv translation tablesto .dmpxlt(l) 

ASCII .glossary(9) 

ascii - map of ASCI I character set.ascii(5) 

ASCI I string, convert between long integer and base-64.a64l(3C) 

ASCII string, convert long integer to.ltostr(3C) 

ASCII, 7-bit, translatecharactersto.conv(3C) 

ASCII, convert binaryfileto, for transmission by mailer.uuencode(l) 

asctime (), asctime_r() - convert tm structure date and ti me to string.ctime(3C) 

asecure - control access to Audio.asecure(lM) 
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aserver . 

aserver - Audio . 

asin() - arcsine function. 

asind() - arcsine function (degrees). 

asindf () - arcsine function (float, degrees). 

asinf() - arcsine function (float). 

asinh () - inverse hyperbolic sine function . 

ask for user response for SD-UX . 

assembler (Precision Architecture) . 

assembler and link editor output format . 

assembler debugger. 

assert () - verify program assertion. 

assertion, verify program . 

assign buffering to a stream file. 

assignment database entry, manipulate device . 

asynchronous I/O, error status . 

asynchronous I/O, initiate list of operations . 

asynchronous I/O, POSIX . 

asynchronous I/O, start write . 

asynchronous I/O, status, return . 

asynchronous I/O, suspend for completion . 

asynchronous I/O, synchronize. 

asynchronous I/O, wait for completion . 

asynchronous serial modem I i ne control . 

asynchronous, cancel I/O. 

asynchronous, start read . 

at, batch, and crontab queuedescription file. 

at, prototype job filefor . 

at - execute commands at a later time. 

atan() - arctangent function. 

atan2() - arctangent-and-quadrant function. 

atan2d() - arctangent-and-quadrant function (degrees) . 

atan2df() - arctangent-and-quadrant function (float, degrees). 

atan2f () - arctangent-and-quadrant function (float). 

atand() - arctangent function (degrees) . 

atandf () - arctangent function (float, degrees). 

atanf() - arctangent function (float). 

atanh () - inverse hyperbolic tangent function . 

atexito - register a function to be called at program termination. 

atof () - convert string to double-precision number . 

atoi () - convert string to long integer. 

atoi () - convert string to long integer. 

atomically release blocked signalsand wait for interrupt . 

attach a STREAMS file descriptor to an object in thefilesystem namespace 

attach shared memory to data segment . 

attempt to lock a read-write lock for writing. 

attribute object, initializeor destroy thread. 

attribute, for window, control functions . 

attributes associated with a message queue, get . 

attributes - descri be audio file. 

attributesfor group, get special . 

attributes of a DOS file, change. 

attributes, change program's internal . 

attributes, change RCS file. 

attributes, objects, and storage formats for SD . 

attributes, set and get for pthread. 

attributes, window, set and clear. 

attroff () - restricted window attribute control functions. 

attron() - restricted window attribute control functions. 

attrset () - restricted window attribute control functions. 

attr_get () - window attribute control functions. 


.aserver (1M) 

.aserver (1M) 

.asin(3M) 

.asind(3M) 

.asind(3M) 

.asin(3M) 

.asinh(3M) 

.swask(lM) 

.as(l) 

.a.out(4) 

.adb(l) 

.assert(3X) 

.assert(3X) 

.setbuf(3S) 

.getdvagent(3) 

.aio_error(2) 

.lio_listio(2) 

.aio(5) 

.aio_write(2) 

.aio_return(2) 

.aio_suspend(2) 

.aio_fsync(2) 

.aio_suspend(2) 

.modem(7) 

.aio_cancel(2) 

.aio_read(2) 

.queuedefs(4) 

.proto(4) 

.at(l) 

.atari (3M) 

.atari 2(3M) 

.atan2d(3M) 

.atan2d(3M) 

.atari 2(3M) 

.atand(3M) 

.atand(3M) 

.atari (3M) 

.atanh(3M) 

.atexit(2) 

.strtod(3C) 

.strtol(3C) 

.strtol(3C) 

.sigpause(2) 

.fattach(3C) 

.shmop(2) 

.pthread)rwlock_wrlock(3T) 

.pthread_attr_dinit(3T) 

.attr_get(3X) 

.mq_getattr(2) 

.attributes(l) 

.getprivgrp(l) 

.doschmod(l) 

.chatr(l) 

.rcs(l) 

.sd(4) 

pth r eadattrgetdetac h state(3T) 

.standend(3X) 

.attroff(3X) 

.attroff(3X) 

.attroff(3X) 

.attr_get(3X) 
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attr_off () - window attribute control functions.attr_get(3X) 

attr^on () - window attribute control functions.attr_get(3X) 

attr_set () - window attribute control functions.attr_get(3X) 

audctl(2) - HP-UX Auditing System described.audit(5) 

audcti () - start or halt auditing system; set or get audit files .audcti (2) 

audevent(lM)-HP-UX Auditing System described .audit(5) 

audevent - change or display event or system call audit status .audevent(lM) 

audeventstab - define and describe audit system events .audeventstab(4) 

audiblesignal .beep(3X) 

audio-audio tools availablethrough HP VUE .audio(5) 

Audio.Audio(l) 

audio control panel .seeaudio(5) 

audio editor, .seeaudio(5) 

audio file and data formats.seeaudio(5) 

audio file, convert .convert(l) 

audio file, describe.attributes(l) 

audio file, play .send sound(l) 

audio library.seeaudio(5) 

audio security.seeaudio(5) 

audio setup.seeaudio(5) 

audio, control access to .asecure(lM) 

audisp(lM)i- HP-UX Auditing System described.audit(5) 

audisp - display audit information as requested by parameters .audisp(lM) 

audit(5) - HP-UX Auditing System described .audit(5) 

audit - change or display event or system call audit status .audevent(lM) 

audit files, set or get .audcti(2) 

audit ID (aid ()) for current process, get.getaudid(2) 

audit ID (aid ()), set for current process .setaudid(2) 

audit information, display as requested by parameters .audisp(lM) 

audit process flag for calling process, get .getaudproc(2) 

audit record, write for self-auditing process .audwrite(2) 

audit system events, define and describe .audeventstab(4) 

audit-overflow monitor daemon .audomon(lM) 

audit: audit-overflow monitor daemon .audomon(lM) 

audit: fileformat and other information for auditing.audit(4) 

audit: get events and system calls currently being audited.getevent(2) 

audit: select users to audit .audusr(lM) 

audit: set current events and system calls to be audited .setevent(2) 

audit: set or clear auditing on calling process.setaudproc(2) 

audit: set or display audit file information .audsys(lM) 

audit: set or get audit files .audcti(2) 

audit: start or halt auditing system.audcti(2) 

audit: start or halt auditing system .audsys(lM) 

auditing system.see audit 

auditing system, start or halt.audcti(2) 

auditing, set or clear on calling process.setaudproc(2) 

auditing, suspend or resume on current process.audswitch(2) 

audomon - audit-overflow monitor daemon .audomon(lM) 

audswitch(2) - HP-UX Auditing System described.audit(5) 

audswitch() - suspend or resume auditing on current process.audswitch(2) 

audsys(lM) - HP-UX Auditing System described.audit(5) 

audsys - start or halt the auditing system and set or display audit file information .audsys(lM) 

audusr(lM) - HP-UX Auditing System described .audit(5) 

audusr - select users to audit .audusr(lM) 

audwrite(2) - HP-UX Auditing System described.audit(5) 

audwrite () - write audit record for self-auditing process.audwrite(2) 

authcap - security databases .authcap(4) 

authck - check internal consistency of Authentication database.authck(lM) 

authdes_create () - obsolete library routines for RPC .rpc_soc(3N) 

authdes_seccreate () - library routines for secure remote procedure calls.secure_rpc(3N) 

authentication and print request server, PC-NFS .pcnfsd(lM) 
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Authentication database, check internal consistency of.authck(lM) 

authentication fileformat, for ppp .ppp.Auth(4) 

authentication information routines for PAM .pam_set_item(3) 

authentication module, configuration filefor pluggableauthentication module.pam.conf(4) 

authentication module, pluggable.pam(3) 

authentication service, modify and delete user credentials for an authentication service.pam_setcred(3) 

authentication transaction routines for PAM .pam_start(3) 

authentication within the PAM framework, perform.pam_authenticate(3) 

authentication, account, session and password management PAM modules for UNIX .pam_unix(5) 

authnone create () - library routines for client sideremote procedure call authentication rpc_dnt_auth(3N) 
authsys^create () -1 ibrary routi nes for cl ient side remote procedure call authentication .. rpc_clnt_auth(3N) 
authsys_defauit () - library routines for client sideremote procedure call authentication rpc_dnt_auth(3N) 

authunix create () - obsolete I i brary routi nes for RPC .rpc_soc(3N) 

authunix_create_defauit () - obsolete library routines for RPC .rpc_soc(3N) 

auth_destroy () - library routines for client side remote procedure call authentication .rpc_dnt_auth(3N) 

autoboot sequence.pdc(lM) 

automatically mount NFS filesystems.automount(lM) 

automount - automatically mount NFS filesystems.automount(lM) 

autopush - manage system database of automatically pushed STREAMS modules.autopush(lM) 

autoxO - SCSI media changer device drivers.autochanger(7) 

auto_parms - Initial system configuration/DPICP support script .auto parms(lM) 

availability(LVM), set volume group .vgchange(lM) 

availableDOS disk clusters, report number of.dosdf(l) 

available, login when VFIE home machine is not .vhe altlog(lM) 

awk - text pattern scanningand processing language.awk(l) 

back into input stream, push character.ungetc(3S) 

back into input stream, push wide character .ungetwc(3C) 

background batch execution .at(l) 

background character and rendition using a complex character .bkgrnd(3X) 

background character and rendition using a single-bytecharacter .bkgd(3X) 

background process group .glossary(9) 

background processes to complete, wait for .wait(l) 

backspacesand reverse line-feeds, remove from text .col(l) 

backup - backup or archive the file system.backup(lM) 

backup file, create or updateLVM volume group configuration .vgcfgbackup(lM) 

backup.glossary(9) 

backup, incremental filesystem dump.dump(lM) 

backup, incremental filesystem dump over network .dump(lM) 

banner - make posters in large letters.banner(l) 

base offset for an object file, get .elf_getbase(3E) 

base two logarithm functions.log2(3M) 

base-2 exponential function .exp2(3M) 

base-64 ASCI I string, convert long integer to.a64l(3C) 

basename, dirname - extract portions of path names .basename(l) 

basename () - return final component of path name.basename(3C) 

basic integer data types .inttypes(5) 

BasicSerial and HP AdvanceLink server.pcserver(lM) 

batch, at, and crontab queuedescription file.queuedefs(4) 

batch - execute commands immediately .at(l) 

batch mail interface.fastmail(l) 

baud rate, get terminal .baudrate(3X) 

baud rate, tty, set or get.cfspeed(3C) 

baudrate () - get terminal baud rate.baudrate(3X) 

be - arbitrary-precision arithmetic language.bc(l) 

bcmp() - BSD memory compare .memory(3C) 

bcopy () - BSD memory copy .memory(3C) 

bdf - report number of free disk blocks (Berkeley version) .bdf(lM) 

bdiff - bigdiff .bdiff(l) 

beep() - audiblesignal .beep(3X) 

beginning of file, list first few lines at .head(l) 

behavior, advise system of process's expected paging.madvise(2) 
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Bessel functions of the first kind. 

Bessel functions of the second kind. 

bfs - big file scanner . 

bgets () - read stream up to next delimiter . 

bigdiff . 

big file scanner . 

bill fee to user based on system usage. 

binary directories, install object files in. 

binary file, convert to ASCI I for transmission by mailer .. 
binary files used by file system administration commands 

binary files, format tracing and logging. 

binary input/output to a stream file, buffered . 

binary or object file, find the printable strings in an. 

binary program files for given name, find location of. 

binary search routine for sorted tables. 

binary search tree, manage a . 

bind a socket to a privileged IP port . 

bind address to transport endpoint (X/OPEN TLI-XTI) .... 

bind services, library routines for RPC . 

bind threads to processors. 

bind to a particular Network I nformation Service server . 

bind () - bi nd an address to a socket . 

binder processes, Network I nformation Service (NIS) . 

bindresvport () - bind a socket to a privileged IP port . 

biod - N F S bl ock I /O daemon . 

bit bucket. 


Entry Name(Section) 

.jO(3M) 

.yO(3M) 

. bfs(l) 

.bgets(3G) 

.bdiff(l) 

. bfs(l) 

.acctsh(lM) 

.cpset(lM) 

.uuencode(l) 

.fs_wrapper(5) 

.netfmt(lM) 

.fread(3S) 

.strings(l) 

.whereis(l) 

. bsearch(3C) 

. tsearch(3C) 

.bindresvport(3N) 

.t_bind(3) 

.rpcbind(3N) 

pthread_processor_bind_np(3T) 

.ypset(lM) 

.bind(2) 

.ypserv(lM) 

.bindresvport(3N) 

.nfsd(lM) 

.null (7) 


bkgd () - set or get background character and rendition usinga single-bytecharacter. bkgd(3X) 

bkgrnd () - set or get background character and rendition using omplex character. bkgrnd(3X) 

blank lines, reduce multiple adjacent to single blank line. ssp(l) 

blank lines, remove all from file . rmnl(l) 


biclose () - terminal block-mode library interface . blmode(3C) 

biget () - terminal block-mode library interface . blmode(3C) 

bimode - terminal block mode interface. blmode(7) 


bimode () - terminal block-mode library interface. blmode(3C) 

block count and checksum of a file, print . sum(l) 

block count and checksum of a file, print . sum(l) 

block. glossary (9) 

block mode terminal interface. blmode(7) 


block signals.sigblock(2) 

block size, dump file system.dumpfs(lM) 

block special file .glossary(9) 

block, enableor disableduring read .nodelay(3X) 

block-mode terminal I/O library interface.blmode(3C) 

blocked signals, examine and change .sigprocmask(2) 

blocked signals, release and atomically wait for interrupt .sigpause(2) 

blocking on input, control .notimeout(3X) 

blocking status of a message queue associated with a descriptor, set.mq_setattr(2) 

blocks, report number of free disk (Berkeley version) .bdf(lM) 

biopen () - terminal block-mode library interface .blmode(3C) 

biread() - terminal block-mode library interface .blmode(3C) 

biset () - terminal block-mode library interface .blmode(3C) 

boot area .glossary(9) 

boot device configuration table.bootconf(4) 

boot .glossary(9) 

boot programs; install, update, or remove from a disk device.mkboot(lM) 

Boot Protocol server, Internet .bootpd(lM) 

boot ROM .glossary(9) 

boot - run bootstrap process.boot(lM) 

boot server, remote (diskless).rbootd(lM) 


boot the system . reboot(2) 

boot, loadable modules for running kernel during boot . loadmods(4) 
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Description Entry Name(Section) 

boot-up .glossary(9) 

bootable, build a bootable HP-UX kernel or kernel modules .mk_kernel(lM) 

bootconf - boot device configuration table.bootconf(4) 

BOOTP server, send BOOTREQUEST to .bootpquery(lM) 

bootpd -1 nternet Boot Protocol server .bootpd(lM) 

bootpd, command linetoolsfor DHCP elements of.dhcptools(lM) 

bootpquery - send BOOTREQUEST to BOOTP server .bootpquery(lM) 

bootptab entry, get or put .getbootpent(3X) 

BOOTREQUEST, send to BOOTP server .bootpquery(lM) 

bootstrap and installation utility, HP-UX.hpux(lM) 

bootstrap process, run.boot(lM) 

border () - draw borders from single-bytecharacters and renditions.border(3X) 

borders, draw from complex characters and renditions .border_set(3X) 

borders, draw from complex characters and renditions.box_set(3X) 

borders, draw from single-bytecharacters and renditions.border(3X) 

borders, draw from single-bytecharacters and renditions.box(3X) 

border_set () - draw borders from complex characters and renditions.border_set(3X) 

Bourne shell .sh-bourne(l) 

box () - draw borders from single-bytecharacters and renditions .box(3X) 

box set () - draw borders from complex characters and renditions.box_set(3X) 

break a file into multiplen-line pieces.split(l) 

break - exit from enclosing for/next loop .csh(l) 

break - exit from enclosing for/next loop .ksh(l) 

break - exit from enclosing for/next loop.sh-bourne(l) 

break - exit from enclosing for/next loop .sh-posix(l) 

break valueand file size limits, get or set.ulimit(2) 

breaksw - break from switch and resume after endsw.csh(l) 

brk (), sbrk () - change data segment space allocation .brk(2) 

broadcast message simultaneously to all users .wall(lM) 

bs - a compiler/interpreter for modest-sized programs.bs(l) 

BSD-4.2-compatible kill (), sigvecQ, and signal () system calls.bsdproc(3C) 

BSD-4.2-compatible kill (), sigvecQ, and signal () system calls.ki 11 pg(2) 

bsd signal () - simplified signal facilities.bsd_signal(3C) 

bsearch () - binary search routine for sorted tables .bsearch(3C) 

bss (uninitialized data) allocation space of object files, print section sizes and.size(l) 

btmp file.login(l) 

btmp (), utmp (), wtmp () - utmp, wtmp, btmp user accounting file entry format .utmp(4) 

buffer, flush with or without closing stream.fclose(3S) 

buffer, split into fields.bufsplit(3G) 

buffered binary input/output to a stream file .fread(3S) 

buffered input/output standard stream file package.stdio(3S) 

buffering, assign to a stream file.setbuf(3S) 

buffers, flush to disk.sync(2) 

buffers, flush unwritten system buffers to disk.sync(lM) 

buffers, periodically flush unwritten system buffers to disk .syncer(lM) 

buffers, use to perform I/O with an HP-IB channel .hpib_io(3l) 

bufsplit () - split buffer into fields.bufsplit(3G) 

build a bootable HP-UX kernel or kernel modules .mk_kernel(lM) 

build a makefile . mkmf(l) 

build an HP-UX system.config(lM) 

build and install Network Information Service databases.ypinit(lM) 

build or access a binary search tree .tsearch(3C) 

bundled C compiler .cc bundled(l) 

bus address .glossary(9) 

bus .see HP-1 B 

bus, stop activity on specified HP-IB .hpib_abort(3l) 

byte order, network and host, convert values between .byteorder(3N) 

byte, compare memory contents with specified.memory(3C) 

byte, find location of in memory .memory(3C) 

byte, set contents of memory area to specified.memory(3C) 

bytes in a file, count .wc(l) 
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Description 

bytes over HP-IB, send command . 

bytes, swap. 

byte^status (), byte status () - test for valid 1- or 2-byte character ... 

bzero () - BSD memory clear. 

C and Pascal execution startup routines. 

C header files, generate . 

C language preprocessor. 

C language, process include and conditional instructions. 

C macro processor . 

C programs, extract strings from C programs to implement shared strings 

C source, extract error messages from into a file. 

C-likesyntax, a shell (command interpreter) with. 

cache file, share, NIS+utility to print out thecontents of. 

cache location information about NIS+servers . 

caching and hashing daemon, password and group. 

caching and hashing statistics, passwrod and group . 

caching: controlling on HP SCSI disk arrays. 

cal - print calendar. 

calculate default disk section sizes. 

calculator, desk. 

calendar - reminder service. 

calendar, print . 

call an initialization routine only once, threads. 

call another (UNIX) system; terminal emulator . 

call graph execution profile data, display. 

call terminal- spawn getty to remote terminal . 

call, data returned by stat/fstat/istat . 

calling process, get audit process flag for . 

calling process, set or clear auditing on. 

calling process, suspend . 

caiioc () - allocate memory for array. 

calirpc () - obsolete library routinesfor RPC . 

calls, system, BSD-4.2-compatiblekiii (), sigvec(), and signal () . 

calls, system, BSD-4.2-compatiblekiii (), sigvec(), and signal () . 

cancel a notification request with a message queue. 

cancel a per-process ti mer. 

cancel asynchronous I/O. 

cancel - cancel requests on an LP printer . 

cancel execution of a thread . 

cancel LP requests from spooling queue on remote system . 

cancel requests on an LP printer . 

cancelabilitystateand type, set and retrieve the current thread's. 

cancellation cleanup handler, register or remove thread . 

cancellation requests, process any pending. 

can change color () - color manipulation functions. 

capabilities, retrieve from theterminfo database. 

capabilities, terminal, get from terminfo database. 

captoinfo - convert a termcap description into a terminfo description . 

card access information, network I/O . 

carriage control characters, ASA, interpret . 

cartridge tape device access drivers. 

Cartridge Tape I/O Utility, CS/80 . 

cartridge tape, hard disk, or fiexi bl e disk media, initialize. 

cartridge, partition DDS tape. 

case - execute list associated with pattern that matches word . 

case - execute list associated with pattern that matches word . 

case - label in a switch statement . 

cat a VxFS file system. 

cat after uncompacting Huffman coded files (see pack(l)) . 

cat - concatenate, copy, and print files. 

cat files for on-line manual pages, create. 


Entry Name(Section) 

.hpib_send_cmnd(3l) 

.swab(3C) 

.nl_tools_16(3X) 

.memory(3C) 

. crt0(3) 

.rpcgen(l) 

.cpp(l) 

.cpp(l) 

. ni4(l) 

.xstr(l) 

.mkstr(l) 

. csh(l) 

.nisshowcache(lM) 

.niscachemgr(lM) 

.pwgrd(lM) 

.pwgr_stat(lM) 

.dcc(lM) 

.cal(l) 

.disksecn(lM) 

.dc(l) 

.calendar(l) 

.cal(l) 

.pthread_once(3T) 

.cu(l) 

.gprofd) 

.ctd) 

. stat(5) 

.getaudproc(2) 

.setaudproc(2) 

.napms(3X) 

.malloc(3C) 

.rpc_soc(3N) 

.bsdproc(3C) 

killpg(2) 

.mq_notify(2) 

.rmtimer(3C) 

.aio_cancel(2) 

.I Pd) 

.pthread_cancel(3T) 

.rcancel(lM) 

.I Pd) 

pthread_setcancelstate(3T) 
.. pthread_cleanup_pop(3T) 

.pthread_testcancel(3T) 

.can_change_color(3X) 

.tigetflag(3X) 

.tput(l) 

.captoinfodM) 

.I an (7) 

.asa(l) 

.ct(7) 

.tciod) 

.mediainit(l) 

.mediainit(l) 

.ksh(l) 

.sh-posix(l) 

.csh(l) 

.fscat_vxfs(lM) 

.compact(l) 

.cat(l) 

.catman(lM) 
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catalog file, generate a formatted message .gencat(l) 

catalog file, message, create for modification .findmsg(l) 

catalog for reading, close or open NLS message.catopen(3C) 

catalog, set the default message.setcat(3) 

catalogs, message, find strings for inclusion in .findstr(l) 

catciose () - close N LS message catalog for reading .catopen(3C) 

catgets(3C), insert callsto based on findstr(l) output .insertmsg(l) 

catgets () - get an N LS program message.catgets(3C) 

catman - create the cat files for the manual.catman(lM) 

catopen() - open NLS message catalog for reading .catopen(3C) 

causethecallingthread to terminate .pthread_exit(3T) 

cbreak () - input mode control functions.cbreak(3X) 

cbrt (), cbrtf () - cube root functions.cbrt(3M) 

cbrtf (), cbrt () - cube root functions.cbrt(3M) 

ccat - uncompact and cat files using Huffman code (see pack(l) .compact(l) 

cchar_t, get a wide character string and rendition from .getcchar(3X) 

cchar_t, set from a wide character string and rendition.setcchar(3X) 

cc bundled - bundled C compiler .cc bundled(l) 

cd - change working directory.cd(l) 

cd - change working directory.csh(l) 

cd - change working directory .ksh(l) 

cd - change working directory.sh-bourne(l) 

cd - change working directory .sh-posix(l) 

CD-ROM filesystems, mount and unmount.pfsmount(lM) 

CD-ROM: background information.cdrom(4) 

CD-ROM: format of a CDFS cdnode .cdnode(4) 

cdc - change the delta commentary of an SCCS delta.cdc(l) 

CDFS cdnode, format of a.cdnode(4) 

CDFS filesystem disk blocks, report number of free.df_hfs(lM) 

CDFS filesystems, mount and unmount.mountcdfs(lM) 

cdnode - format of a CDFS cdnode .cdnode(4) 

cdrom - CD-ROM background information.cdrom(4) 

ceil() - ceiling function .ceil(3M) 

ceiling function .ceil(3M) 

cent - Centronics-compatible interface .cent(7) 

Centronics-compatible interface.cent(7) 

certify mass storage media .mediainit(l) 

cfgetispeed() - get tty input baud rate.cfspeed(3C) 

cfgetospeed () - get tty output baud rate.cfspeed(3C) 

cfi - configure a SCSI disk array LUN .cfl(lM) 

cfsetispeed() - set tty input baud rate .cfspeed(3C) 

cf setospeed () - set tty output baud rate .cfspeed(3C) 

chad - add, modify, delete, copy, or summarize file access control lists (ACLs) .chacl(l) 

change (delta) to an SCCS file, make a.delta(l) 

change access rights on an NIS+object .nischmod(l) 

change active controllers on HP-IB .hpib_pass_ctl(3l) 

change attributes of a DOS file.doschmod(l) 

change characteristics of physical volumeinLVM volume group.pvchange(lM) 

change current login to a new group .newgrp(l) 

change data format of and copy a (tape) file.dd(l) 

change data segment space allocation .brk(2) 

change default login shell.chsh(l) 

change delta commentary of an SCCS delta .cdc(l) 

change file mode access permissions.chmod(l) 

change file mode access permissions.chmod(2) 

change file owner or group .chown(l) 

change global search path for dynamically loadable kernel modules .modpath(2) 

change login name.su(l) 

change login password in Network Information System (NIS) .yppasswd(l) 

change login password .passwd(l) 

changeLVM logical volume characteristics .Ivchange(lM) 
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Description 

change machine information . 

change NIS+password information . 

change or add valueto environment. 

change or display event or system call audit status. 

change or examine blocked signals. 

change or examine signal action . 

change or examine signal action . 

change or query stream configuration. 

change or reformat a text file . 

change owner and group of a file . 

change owner and/or group in access control list (ACL). 

change owner of an NIS+ object . 

change priority of a process . 

change priority of running processes. 

change program's internal attributes . 

change RCS file attributes. 

change real-time priority. 

change renditions of characters in a window . 

change root directory. 

change root directory for a command . 

change selected characters. 

change state, wait for child process to . 

change state, wait for child process to. 

change system configuration file. 

change the default stacksize. 

change the group owner of an NIS+object. 

change the name of a file. 

change the name of a file . 

change the signal mask of thecallingthread. 

change the time to live valueof an NIS+object . 

change user information in password file; used by finger. 

change user's secure RPC key. 

change working directory. 

change working directory . 

change, access, and/or modification times of a file, update. 

changer device driver, SCSI media . 

changesNIS information. 

changing NIS information, server for . 

channel from buffers, perform I/O with an HP-1 B . 

channel, create an interprocess . 

character and rendition to a window, add a complex . 

character and rendition, complex, input from a window . 

character and rendition, complex, insert into a window. 

character and rendition, input a single-byte from a window. 

character and rendition, single-byte, insert into a window. 

character back into input stream, push . 

character code set, convert to another . 

character code set, convert to another. 

character device special file, control . 

character . 

character or data word from a stream file, get . 

character or word, put on a stream . 

character rendition, write and immediately refresh the pad . 

character sequences for display/keyboard, convert file data order . 

character set . 

character special file. 

character string and rendition, wide, get from a cchar_t . 

character string operations . 

character string or stream file, read from with formatted input conversion 

character string, multi-byte, input from a window . 

character, generate printablerepresentation of . 


Entry Name(Section) 

.setuname(lM) 

.nispasswd(l) 

.putenv(3C) 

.audevent(lM) 

.sigprocmask(2) 

.sigaction(2) 

.sigwait(2) 

.strchg(lM) 

.newform(l) 

.chown(2) 

.chownacl(3C) 

.nischown(l) 

.nice(2) 

.renice(l) 

.chatr(l) 

.rcs(l) 

.rtprio(2) 

.chgat(3X) 

.chroot(2) 

.chroot(lM) 

.tr(l) 

.wait3(2) 

.waitid(2) 

.ch_rc(lM) 

pth r eaddefau I tstacksi ze_n p(3T) 

.nischgrp(l) 

.mv(l) 

.rename(2) 

.pthread_sigmask(3T) 

.nischttl(l) 

.chfn(l) 

.chkey(l) 

.cd(l) 

.chdir(2) 

.touch(l) 

.autochanger(7) 

.ypupdate(3C) 

.ypupdated(lM) 

.hpib_io(3l) 

.pipe(2) 

.add_wch(3X) 

.in_wch(3X) 

.ins_wch(3X) 

.inch(3X) 

.insch(3X) 

.ungetc(3S) 

.iconv(l) 

.iconv(3C) 

.ioctl (2) 

.glossary (9) 

.getc(3S) 

.putc(3S) 

.pechochar(3X) 

.forder(l) 

. glossary(9) 

.glossary (9) 

.getcchar(3X) 

.string(3C) 

.scanf(3S) 

.innstr(3X) 

.unctrl(3X) 
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character, get a multi-byte character length limited string from the terminal .getnstr(3X) 

character, get a multi-byte character stringfrom theterminal .getstr(3X) 

character, get a wide character from a terminal .get_wch(3X) 

character, insert a wide-character string into a window .ins_nwstr(3X) 

character, multi-byte, insert into a window.insnstr(3X) 

character, push onto the input queue .ungetch(3X) 

character, single-byte, get from theterminal .getch(3X) 

character-string login name of the user, get.cuserid(3S) 

Character-Terminal User Environment (CUE), HP .cue(l) 

characteristics for cue, set terminal .cuegetty(lM) 

characteristics of a disk device, describe.diskinfo(lM) 

characteristics of nodes on FDDI ring, list.fddinet(lM) 

characteristics of physical volume in LVM volume group, change.pvchange(lM) 

characteristics, change LVM logical volume .Ivchange(lM) 

characters and renditions, an array of single-byte, input from a window.inchnstr(3X) 

characters and renditions, complex, draw lines from.hlineset(3X) 

characters and renditions, draw lines from single-byte.hline(3X) 

characters and strings conversions, multibyte.multibyte(3C) 

characters in a file, count .wc(l) 

characters in a file, unprintableand non-ASCI I, make visible or invisible.vis(l) 

characters, alter, delete, modify, substitute, or translate.tr(l) 

characters, ASA carriage control, interpret .asa(l) 

characters, classify according to type .ctype(3C) 

characters, classify according to type .wctype(3C) 

characters, how to type control .ascii(5) 

characters, renditions of, change in a window .chgat(3X) 

characters, tools to process 16-bit.nl_tools_16(3X) 

characters, translateto upper-case, lower-case, or 7-bit ASCII .conv(3C) 

characters, wide, input a string of, from a window.innwstr(3X) 

charadv () - get character and advance pointer to next character .nl_tools_16(3X) 

charat () - get valueof 8- or 16-bit character .nl_tools_16(3X) 

chargefee - charge fee to user based on system usage.acctsh(lM) 

charmap - symbolictranslation filefor localedef scripts.charmap(4) 

chatr - change program's internal attributes.chatr(l) 

chdir - change current working directory .csh(l) 

chdir () - change working directory .chdir(2) 

check and repair VxFS filesystem .fsck_vxfs(lM) 

check filesystem consistency and interactively repair .fsck(lM) 

check filesystem consistency and interactively repair (generic) .fsck(lM) 

check if system has been converted to a trusted system.iscomsec(2) 

check in RCS revisions.ci(l) 

check internal consistency of Authentication database.authck(lM) 

check internal revision numbers of HP-UX files.revck(lM) 

check nroff/troff files.checknr(l) 

check or print documents formatted with themm macros .mm(l) 

check or repair a physical volumein LVM volume group .pvck(lM) 

check out RCS revisions.co(l) 

check password or group file.pwck(lM) 

check Product Description File against file system.pdfck(lM) 

check the network, scatter data to.spray(3N) 

check theuucp directories and permissionsfile .uucheck(lM) 

checker, generic filesystem quota consistency.quotacheck(lM) 

checker, hfs file system quota consistency.quotachecknfs(lM) 

checker, VxFS filesystem quota consistency .quotacheckvxfs(lM) 

checking VxFS filesystem with label .volcopy_vxfs(lM) 

checking, copy file systems with label .volcopy(lM) 

checking, copy file systems with label .volcopy_hfs(lM) 

checknr - check nroff/troff files.checknr(l) 

checksum and block count of a file, print .sum(l) 

checksum and block count of a file, print .sum(l) 

cheduling policy and associated parameters, get and set.pthread_getschedparam(3T) 
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chfn - change user information in password file; used by finger.chfn(l) 

chgat () - change renditions of characters in a window .chgat(3X) 

chgrp - change group of file .chown(l) 

child process and process times, get.times(2) 

child process.fork(2) 

child process.glossary(9) 

child process to change state, wait for .wait3(2) 

child process to stop or terminate, wait for.wait(2) 

child process, wait to change state.waitid(2) 

children, synchronisea window with .syncok(3X) 

chkey - change user's secure RPC key.chkey(l) 

chmod - change file mode access permissions.chmod(l) 

chmod () - change file mode access permissions.chmod(2) 

chown - change file owner .chown(l) 

chown () - change owner and group of a file .chown(2) 

chownaci () - change owner and/or group in access control list (ACL).chownacl(3C) 

chroot - change root directory for a command .chroot(lM) 

chroot () - change root directory.chroot(2) 

chsh - change default login shell .chsh(l) 

ch_rc - change system configuration file.ch_rc(lM) 

ci - check in RCS revisions.ci(l) 

circuit, X.25 switched virtual, clear .clrsvc(lM) 

ckpacct - check size of process accounting file.acctsh(lM) 

cksum - print filechecksum and sizes.sum(l) 

class-dependent data translation of ELF files.elf_xlate(3E) 

class-dependent object file header for ELF files, retrieve .elf_getehdr(3E) 

class-dependent program header tablefor ELF files, retrieve.elf_getphdr(3E) 

class-dependent section header for ELF files, retrieve.elf_getshdr(3E) 

classification macro, floating-point.fpclassify(3M) 

classify characters according to type .ctype(3C) 

classify characters according to type .wctype(3C) 

clean file system at last system shutdown, test for .fsclean(lM) 

clean-up, uucp spool directory.uudeanup(lM) 

clear a window.clear(3X) 

clear - clear terminal screen .clear(l) 

clear from cursor to end of line.clrtoeol(3X) 

clear from cursor to end of window.clrtobot(3X) 

clear inode.clri(lM) 

clear or set auditing on calling process.setaudproc(2) 

clear the process environment .clearenv(3C) 

clear window attributes.standend(3X) 

clear X.25 switched virtual circuit .drsvc(lM) 

clear () - clear a window.dear(3X) 

clearenv () - clear the process environment.dearenv(3C) 

clearerr () - clear I/O error on stream .ferror(3S) 

clearok () - terminal output control functions.dearok(3X) 

client and server, NIS+, initialization utility .nisinit(lM) 

client configuration information file, diskless .info(4) 

CLIENT handles, library routines for dealing with creation and manipulation of .rpc_dnt_create(3N) 

client interface, Network Information Service.ypdnt(3C) 

client side, library routines for client side calls, rpc.rpc_dnt_calls(3N) 

client, library routines for client side remote procedure call authentication.rpc_dnt_auth(3N) 

clients, directories to export toNFS.exports(4) 

clients, export and unexport directories to NFS.exportfs(lM) 

clients, PFS, directories to export to .pfs_exports(5) 

clients, PFS, export and unexport directories to .pfs_exportfs(lM) 

cintraw_create () - obsolete Iibrary routines for RPC .rpc_soc(3N) 

cinttcp create () - obsolete I ibrary routi nes for RPC .rpc_soc(3N) 

cintudp_buf create () - obsolete I ibrary routi nes for RPC .rpc_soc(3N) 

cintupd create () - obsolete I ibrary routi nes for RPC .rpc_soc(3N) 

cint broadcast () - obsolete I i brary routi nes for RPC .rpc_soc(3N) 
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cint caii () - library routines for client sidecalls .rpc_clnt_calls(3N) 

clnt control () - library routines for dealing with CLIENT handles.rpc_clnt_create(3N) 

cintcreate () - library routines for dealing with CLIENT handles.rpc_clnt_create(3N) 

clnt create_vers () - library routines for dealing with CLIENT handles.rpc_clnt_create(3N) 

cint destroy () -1ibrary routinesfor dealing with CLIENT handles.rpc_clnt_create(3N) 

clnt_dg_create () - library routines for dealing with CLI ENT handles.rpc_clnt_create(3N) 

cint_freeres () -1 ibrary routi nes for cl ient side calls .rpc_clnt_calls(3N) 

cint geterr () -1 ibrary routi nes for cl ient side calls .rpc_clnt_calls(3N) 

cint_pcreateerror () - library routines for dealing with CLI ENT handles.rpc_clnt_create(3N) 

cint_perrno () -1 ibrary routi nes for cl ient side calls .rpc_clnt_calls(3N) 

cint_perror () -1 ibrary routi nes for cl ient side calls .rpc_clnt_calls(3N) 

clnt jaw create () - library routines for dealing with CLI ENT handles.rpc_clnt_create(3N) 

cint spcreateerror () - library routines for dealing with CLI ENT handles.rpc_clnt_create(3N) 

cint sperrno () -1 ibrary routi nes for cl ient side calls .rpc_cint_calls(3N) 

cint sperror () -1 ibrary routi nes for cl ient side calls .rpc_clnt_calls(3N) 

clnt_tli_create () - library routines for dealing with CLI ENT handles.rpc_clnt_create(3N) 

cint_tp_create () - library routi nes for dealing with CLI ENT handles.rpc_clnt_create(3N) 

clnt_vc_create () - library routines for dealing with CLIENT handles.rpc_clnt_create(3N) 

clock daemon .cron(lM) 

clock dateand time, get system.gettimeofday(2) 

clock operations .clocks(2) 

clock resolution, get .clocks(2) 

clock tick .glossary(9) 

clock time value, get .clocks(2) 

clock time value, set.clocks(2) 

clock () - report CPU time used .clock(3C) 

clock, correct theti me to synchronize thesystem .adjtime(2) 

clock, get current valueof system-wide.getclock(3C) 

clock, set valueof system-wide.setclock(3C) 

clock, system, display current dateand time or set to new value.date(l) 

clocks - clock operations .clocks(2) 

clock getres () - get clock resolution .clocks(2) 

clock gettime () - get clock time value.clocks(2) 

clocksettime () - set clock time value.clocks(2) 

clonedriver: STREAMS driver .clone(7) 

clone - open a major and minor device pair on a STREAMS driver .clone(7) 

close a crash dump descriptor .cr_close(3) 

close a message queue descri ptor .mq_close(2) 

close a named semaphore .sem_close(2) 

close a shared object.dlclose(3C) 

close a stream.fclose(3S) 

closelegal user shells file.getusershell(3C) 

close or open NLS message catalog for reading.catopen(3C) 

close or open pipe 1 10 to or from a process .popen(3S) 

close transport endpoint (X/OPEN TLI-XTI).t_close(3) 

closet) - cl ose a file descri ptor .close(2) 

close, access, or open a directory and associated directory stream.directory(3C) 

ciosedir () - close a currently open directory .directory(3C) 

cioseiog () - close system log file.syslog(3C) 

ciri - clear inode.clri(lM) 

cirsvc - clear X.25 switched virtual circuit .clrsvc(lM) 

cirtobot () - clear from cursor to end of window.clrtobot(3X) 

cirtoeoi () - clear from cursor to end of line.clrtoeol(3X) 

cluster, writea message simultaneously to all users.wali(lM) 

clusters, DOS disk, report number of free .dosdf(l) 

cmp - compare two files.cmp(l) 

co - check out RCS revisions.co(l) 

codefiles, object, in a library, find optimum sequence for.iorder(l) 

code set conversion, character .iconv(l) 

code set conversion, character.iconv(3C) 

code widths, set and get E UC for Idterm.eucset(l) 
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code, processor-dependent (firmware).pdc(lM) 

coded character set.glossary(9) 

col - filter reverse line-feeds and backspaces from text .col(l) 

collating element .glossary(9) 

collation.glossary (9) 

collation sequence.glossary(9) 

collect system diagnostic messages to form error log .dmesg(lM) 

color manipulation functions.can_change_color(3X) 

color„content () - color manipulation functions.can_change_color(3X) 

color_set () - window attribute control functions.attr_get(3X) 

cols () - number of columns on terminal screen .COLS(3X) 

columns, number of, on terminal screen .COLS(3X) 

comb - combineSCCS deltas.comb(l) 

combine corresponding lines of several files or subsequent lines of one file.paste(l) 

combine SCCS deltas.comb(l) 

combine two LVM logical volumes into one logical volume.Ivmerge(lM) 

comm - select/reject lines common to two sorted files.comm(l) 

command bytes over HP-IB, send.hpib_send_cmnd(3l) 

command - execute a simple command.command(l) 

command execution, set (modify or redefine) environment for .env(l) 

command execution, UNIX system to UNIX system.uux(l) 

command.glossary(9) 

command history and input editor for interactive programs .ied(l) 

command interpreter (shell) with C-likesyntax .csh(l) 

command interpreter.glossary(9) 

command linetool for DHCP elements of bootpd .dhcptools(lM) 

command name, find program files that execute under given .which(l) 

command on a remote host, execute a.rcmd(3N) 

command on a remote host, execute.on(l) 

command options, parse.getopt(l) 

command options, parse.getopts(l) 

Command Set 1980 .glossary(9) 

Command Set 80 CartridgeTape I/O Utility.tcio(l) 

command summary from per-process accounting records.acctcms(lM) 

command usage summary and accounting data, accumulate.acctsh(lM) 

command, change root directory.chroot(lM) 

command, execute a simple.command(l) 

command, measure time used to execute a.time(l) 

command, remote, return a stream to.rcmd(3N) 

command, report execution time of, process accounting data and system activity.timex(l) 

command, return stream to a remote .rexec(3N) 

command, run at nondefault priority .nice(l) 

command, run immune to hangups.nohup(l) 

command, shell, issuea .system(3S) 

commands to Terminal Session Manager, send .tsm.command(l) 

commands, execute at a later time .at(l) 

commands, filesystem administration configuration and binary files.fs_wrapper(5) 

commands, generic I/O device control .ioctl(5) 

commands, install new .install(lM) 

commands, output to the terminal.putp(3X) 

commands, RCS, description of.rcsintro(5) 

commands, show last executed in reverse order .lastcomm(l) 

commands: STREAMS ioctl commands.streamio(7) 

commentary of an SCCS delta, change delta .cdc(l) 

common archive file format .ar(4) 

common logarithm functions.loglO(3M) 

common to two sorted files, reject/select lines.comm(l) 

communicate interactively with another user .write(l) 

communication domain protocol, local .UNIX(7P) 

communication facilities, interprocess, report status.ipcs(l) 

communication identifier, create interprocess.ftok(3C) 
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communication software for serial and network connections .kermit(l) 

communication, create an endpoint for .socket(2) 

communications, Interprocess.socket(7) 

communications, Interprocess.xopen_networking(7) 

compact - compact files using Huffman code (see pack(l).compact(l) 

compact files using Huffman code (see pack(l).compact(l) 

compact list of users currently on the system .users(l) 

compaction, copy HFS filesystem with.dcopy(lM) 

compare contents of memory with byte.memory(3C) 

compare contents of two directories.dircmp(l) 

compare or print out terminfo descriptions.infocmp(lM) 

compare Product Description Fileand filesystem .pdfck(lM) 

compare RCS revisions .rcsdiff(l) 

compare sorted files; reject/select common lines .comm(l) 

compare three files and find differences.dif¥3(l) 

compare two files and find differences .diff(l) 

compare two files and mark differences .diffmk(l) 

compare two files and show differences side-by-side .sdiff(l) 

compare two files.cmp(l) 

compare two strings.string(3C) 

compare two thread identifiers.pthread_equal(3T) 

compare two versions of an SCCS file .sccsdiff(l) 

compare two wide strings.wcstring(3C) 

comparison macro, floating-point (<) .isless(3M) 

comparison macro, floating-point (<=).islessequal(3M) 

comparison macro, floating-point (o).isiessgreater(3M) 

comparison macro, floating-point (>) .isgr eater (3M) 

comparison macro, floating-point (>=) .isgr eater equal (3M) 

comparison macro, floating-point (unordered).isunordered(3M) 

comparison routines for regular expressions .regexp(3X) 

compile a regular expression .regcmp(3X) 

compile and execute regular expressions.re_comp(3X) 

compile and match routines for regular expressions.regexp(3X) 

compile () - regular expression compile routine.regexp(3X) 

compiled terminfo file format .term(4) 

compiler, bundled C .ccbundled(l) 

compiler/interpreter for modest-sized programs.bs(l) 

compilers, rpcgen; generate RPC protocols, C header files .rpcgen(l) 

compilers: terminfo data base compiler .tic(lM) 

compiling routines, regular expression .regcomp(3C) 

complementary error function .erf(3M) 

complete, wait for background processes to .wait(l) 

complex character and rendition, add to a window .add_wch(3X) 

complex character and rendition, input from a window .in_wch(3X) 

complex character and rendition, insert into a window.ins_wch(3X) 

complex character, set or get background character and rendition using .bkgrnd(3X) 

complex character, write and immediately refresh the window.echo_wchar(3X) 

complex characters and renditions, add an array of, to a window.add_wchnstr(3X) 

complex characters and renditions, draw borders.border_set(3X) 

complex characters and renditions, draw borders from .box_set(3X) 

complex characters and renditions, draw lines from.hline_set(3X) 

complex characters and renditions, input an array of, from a window.in_wchnstr(3X) 

composite graphic symbol .glossary(9) 

compress, uncompress, zcat - compress or expand data .compress(l) 

compress or expand data .compress(l) 

compressdir, uncompressdir - compress or expand files in a directory .compress(l) 

compute hash valuefor ELF files.elf_hash(3E) 

compute shortest path and route between hosts.pathalias(l) 

computer system information, display.uname(l) 

computer system information, get .uname(2) 

computer system, set node name.uname(l) 
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Description 

computer system, set node name. 

concatenate two strings . 

concatenate two wide strings . 

concatenate, copy, and print files. 

concurrency level of unbound threads, get and set . 

condition becomes true, wait until the requested status. 

condition variableattributesobject, initializeor destroy. 

condition variable, unblock one or all threads waiting on a conditional variable 

condition variable, wait or timed wait on. 

condition, evaluatefor tru^false . 

conditional expression: return the state of the NIS+ namespace. 

conditions, definefor I/O device interrupt . 

conduct a serial poll on HP-IB . 

config - configure and build an HP-UX system. 

configurable path name variables, get. 

configurablesystem variables, get. 

configuration and loadableflagsfor a module, set and query . 

configuration and status, display LAN device. 

configuration backup file, create or update LVM volume group. 

configuration database, network . 

configuration filefor HPDPS gateway printers. 

configuration filefor inetd . 

configuration filefor NIS updating. 

configuration filefor pluggableauthentication module . 

configuration filefor secure internet services. 

configuration filefor the name-service switch. 

configuration filefor theSNMP agent . 

configuration file, change system. 

configuration file, network tracing and logging. 

configuration file, resolver . 

configuration file, used by DDFA software. 

configuration files used by filesystem administration commands . 

configuration information file, disklessclient . 

configuration information tool, multicast routing. 

configuration tablefor disk arrays . 

configuration table, boot device. 

configuration tool, El SA . 

configuration values, get POSIX. 

configuration values, get string-valued. 

configuration, gated . 

configuration, master kernel configuration information. 

configuration, restore volume group. 

configuration, user, files for pluggableauthentication modules . 

configure and build an HP-UX system. 

configure network interface parameters . 

configure network tracing and logging subsystem database. 

configure system crash dumps. 

configure system crash dumps . 

configure system languageon multi-language systems . 

configure theLP spooling system . 

configure, software products . 

configuring a disk array. 

confirmation from connect request (X/OPEN TLI-XTI). 

confstr () - get string-valued configuration values. 

connect accounting records, manipulate. 

connect all system FDDI network interfaces, initializeand . 

connect request (X/OPEN TLI-XTI). 

connect request issued by a transport user (X/OPEN TLI-XTI) . 

connect to the FDDI network . 

connect () - initiateconnection on socket . 

connected peer, get address of. 


Entry Name(Section) 

.uname(2) 

.string(3C) 

.wcstring(3C) 

.cat(l) 

pthread_getconcurrency(3T) 

.hpib_status_wait(3l) 

.... pthread_condattr_init(3T) 

.pthread_cond_signal(3T) 

.pthread_cond_wait(3T) 

.test(l) 

. nistest(l) 

.io_on_interrupt(3l) 

.hpib_spoll(3l) 

.config(lM) 

.pathconf(2) 

.sysconf(2) 

.kmsystem(lM) 

.lanscan(lM) 

.vgcfgbackup(lM) 

.netconfig(4) 

.pdgwcfg.conf(4) 

.inetd.conf(4) 

.updaters(lM) 

.pam.conf(4) 

.inetsvcs.conf(4) 

.nsswitch.conf(4) 

.snmpd.conf(4) 

.ch_rc(lM) 

.nettlgen.conf(4) 

.resolver (4) 

.pcf(4) 

.fs_wrapper(5) 

.info(4) 

.mrinfo(lM) 

.arraytab(4) 

.bootconf(4) 

.eisaconfig(lM) 

.getconf(l) 

.confstr(3C) 

.gated.conf(4) 

.master (4) 

.vgcfgrestore(lM) 

.pam_user.conf(4) 

.config(lM) 

.ifconfig(lM) 

.nettlconf(lM) 

.crashconf(lM) 

.crashconf(2) 

.geocustoms(lM) 

.Ipadmin(lM) 

.swinstall(lM) 

.newarray(lM) 

.t_rcvconnect(3) 

.confstr(3C) 

.fwtmp(lM) 

.fddisetup(lM) 

.t_listen(3) 

.t_accept(3) 

.fddiinit(lM) 

.connect(2) 

.getpeername(2) 
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connected sockets, create a pair.socketpair(2) 

connection daemon debug utility used by DDFA software, outbound .ocdebug(lM) 

connection daemon used by DDFA software, outbound .ocd(lM) 

connection mapper, multicast router .map-mbone(lM) 

connection on a socket, accept.accept(2) 

connection on a socket, initiate.connect(2) 

connection with another transport user (X/OPEN TLI-XTI).t_connect(3) 

connection, establish an out-bound terminal line .dial(3C) 

connection, receive data (X/OPEN TLI-XTI) .t_rcv(3) 

connection, send data (X/OPEN TLI-XTI) .t_snd(3) 

connections on a socket, listen for .listen(2) 

connectivity, verify LAN with link-level loopback .linkloop(lM) 

consistency checker, generic file system quota .quotacheck(lM) 

consistency checker, hfs file system quota.quotachecknfs(lM) 

consistency checker, VxFS file system quota .quotacheckvxfs(lM) 

consistency of Authentication database, check internal .authck(lM) 

consistency, maintain between kernel and /etc/ioconfig.ioinit(lM) 

console and standard error, displays formatted message on .fmtmsg(3C) 

console - system console interface special file .console(7) 

console, search for during boot process .pdc(lM) 

constants and values for programming, machine-dependent .values(5) 

constants, implementation-specific.Iimits(5) 

constants, language information .langinfo(5) 

constants, math functions and.math(5) 

constants, standard structures and symbolic.unistd(5) 

construct a file system (generic) .mkfs(lM) 

construct a new file system (generic) .newfs(lM) 

construct a new HFS filesystem .newfs_hfs(lM) 

construct an HFS filesystem.mkfs_hfs(lM) 

construct argument list(s) and execute command .xargs(l) 

construct new VxFS file system .newfs_vxfs(lM) 

construct VxFS filesystem.mkfs_vxfs(lM) 

constructs, nroff/troff, tbl, and neqn, remove .deroff(l) 

consumption limit, get or set system resource .getrlimit(2) 

contents of an NIS+directory: list .nisls(l) 

contents of directory, list.Is(l) 

contents of DOS directories, list.dosls(l) 

contents of the NIS+transaction log, display .nislog(lM) 

contents of two directories, compare.dircmp(l) 

context, signal stack, set and/or get .sigstack(2) 

context-dependent file.chmod(l) 

context-dependent file.chmod(2) 

context-sensitive softkey shell.keysh(l) 

continue - resume execution of nearest whileor foreach .csh(l) 

continue - resume next iteration of enclosing for/next loop.ksh(l) 

continue - resume next iteration of enclosing for/next loop .sh-bourne(l) 

continue - resume next iteration of enclosing for/next loop.sh-posix(l) 

continue, resume, or suspend execution of a thread .pthread_resume_np(3T) 

control a file descriptor for ELF files.elf_cntl(3E) 

control a SCSI device.scsictl(lM) 

control address resolution.arp(lM) 

control blocking on input .notimeout(3X) 

control character device special file .ioctl(2) 

control character .glossary(9) 

control characters, ASA carriage, interpret .asa(l) 

control characters, how to type .ascii(5) 

control checking for typeahead .typeahead(3X) 

control commands, generic I/O device .ioctl(5) 

control device driver, SCSI device.scsi_ctl(7) 

control device driver, SCSI device.scsi_pt(7) 

control EOI mode for HP-l B file .hpib_eoi_ctl(3l) 
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control function, for window refresh . 

control functionsfor window attribute . 

control functions, input mode . 

control functions, restricted window attribute . 

control functions, terminal output . 

control functions, tty line. 

control functions, VxFS filesystem . 

control functions, window refresh . 

control input character delay mode . 

control lines on GPIO card, set. 

control network tracing and logging . 

control operations, message. 

control operations, semaphore. 

control operations, shared memory . 

control panel, audio. 

control response to parallel poll on HP-IB . 

control routines for open-files. 

control system log. 

control system resource consumption limit . 

control terminal device (Bell Version 6 compatibility) . 

control the HP-IB interface Remote Enable line. 

control tty device. 

control, asynchronous serial modem lines. 

control, filesystem . 

control, multiprocessor. 

control, uucp status inquiry and job . 

control, version . 

controllers on HP-IB, change active. 

controlling process. 

control ling terminal . 

control ling terminal, generate file name of. 

conv(), - translate characters . 

conventions, file-name suffix. 

conventions, numeric formatting, of current locale, query. 

conversion function, string-to-NaN . 

conversion routines, network station address string. 

conversion, date and time. 

conversion, formatted input, to a varargs argument . 

conversions, multibyte characters and strings . 

convert 9-digit hash codes to compressed spelling reference list 

convert a file system to allow long file names . 

convert access control list (ACL) structure to string form. 

convert between 3-byte integers and long integers. 

convert between long integer and base-64 ASCI I string. 

convert binary file to ASCII for transmission by mailer. 

convert character code set to another . 

convert character code set to another. 

convert - convert audio file. 

convert date and time to string. 

convert date and time to string . 

convert date and time to wide-character string. 

convert DOS file to HP-UX ASCII fileformat . 

convert file keyboard/display data order. 

convert file to stream . 

convert floating-point number to string or string array element 

convert formatted input from a window. 

convert formatted input from a window. 

convert formatted input from a window . 

convert HP-UX ASCII file to DOS fileformat . 

convert login/logoff records to per-session accounting records ... 
convert long doublefloating-point number to string. 


Entry Name(Section) 

.touchwin(3X) 

.attr_get(3X) 

.cbreak(3X) 

.attroff(3X) 

.clearok(3X) 

.tccontrol(3C) 

.vxfsio(7) 

.is_linetouched(3X) 

.halfdelay(3X) 

.gpio_set_ctl(3l) 

.nettl(lM) 

.msgctl(2) 

.semctl(2) 

.shmctl(2) 

.see audio(5) 

hpib_card_ppoll_resp(3l) 

.fcntl(2) 

.syslog(3C) 

.getrlimit(2) 

. stty(2) 

.hpib_ren_ctl(3l) 

.tcattribute(3C) 

.modem(7) 

.fsctl(2) 

.mpctl(2) 

.uustat(l) 

.vc(l) 

.hpib_pass_ctl(3l) 

.glossary(9) 

.glossary (9) 

.ctermid(3S) 

.conv(3C) 

.suffix(5) 

.localeconv(3C) 

.nan(3M) 

.net_aton(3C) 

.strptime(3C) 

.vscanf(3S) 

.multibyte(3C) 

.spell(l) 

.convertfs(lM) 

.acltostr(3C) 

. l3tol(3C) 

.a64l(3C) 

.uuencode(l) 

.iconv(l) 

.iconv(3C) 

.convert(l) 

.ctime(3C) 

.strftime(3C) 

.wcsftime(3C) 

.dos2ux(l) 

.forder(l) 

.fopen(3S) 

.ecvt(3C) 

.mvscanw(3X) 

.vwscanw(3X) 

.vw_scanw(3X) 

.dos2ux(l) 

.acctcon(lM) 

.ldcvt(3C) 
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convert long integer to string.ltostr(3C) 

convert per-session records to total accounting records.acctcon(lM) 

convert spelling reference list words to 9-digit hash codes for spell .spell(l) 

convert string data order.strord(3C) 

convert string to access control list (ACL) structure.strtoacl(3C) 

convert string to double-precision number .strtod(3C) 

convert string to long double-precision number.strtold(3C) 

convert tabs to spaces, and vice versa.expand(l) 

convert text words to 9-digit hash codes for spell .spell(l) 

convert underscores to underlining on terminal.ul(l) 

convert units of measure.units(l) 

convert user format date and time.getdate(3C) 

convert values between host and network byte order .byteorder(3N) 

convert wide character string to double-precision number.wcstod(3C) 

convert wide character stringto long integer .wcstol(3C) 

convert, reblock, translate, and copy a (tape) file.dd(l) 

converted trusted system, check if.iscomsec(2) 

convertfs - convert a file system to allow long file names .convertfs(lM) 

converts old sendmail.cf files to new format.convert_awk(lM) 

convert_awk - converts old sendmai I .cf files to new format .convert_awk(lM) 

coordinate ELF library and application versions.elf_version(3E) 

coordinate, window, transformation, define.mvderwin(3X) 

Coordinated Universal Time (UTC) .date(l) 

Coordinated U niversal Time (UTC) .glossary(9) 

coordinates, get additional cursor and window coordinates.getbegyx(3X) 

coordinates, get cursor and window coordinates.getyx(3X) 

copy a file into memory.copylist(3C) 

copy a region of window.copywin(3X) 

copy access control list (ACL) to another file.cpacl(3C) 

copy displayed CRT terminal output simultaneously in a file.script(l) 

copy file archives in and out.cpio(l) 

copy file systems with label checking.volcopy(lM) 

copy file systems with label checking.volcopy_hfs(lM) 

copy file to a new or existing file .cp(l) 

copy file, publicUNIX system toUNIX system .uuto(l) 

copy files between systems.ftp(l) 

copy files to or from remote system.rcp(l) 

copy files to or from remote system.rcp(l) 

copy HFS filesystem with compaction .dcopy(lM) 

copy in, copy out - transfer uucp-system files in or out .uucico(lM) 

copy memory to another area.memory(3C) 

copy multiplexes to a directory .cp(l) 

copy of standard output, send to specified file.tee(l) 

copy overlapped windows.overlay(3X) 

copy to or from DOS files .doscp(l) 

copy to or from LI F files.lifcp(l) 

copy unwritten system buffers to disk.sync(lM) 

copy unwritten system buffers to disk periodically .syncer(lM) 

copy VxFS filesystem with label checking .volcopy_vxfs(lM) 

copy, add, modify, delete, or summarize file access control lists (ACLs) .chacl(l) 

copy, concatenate, and print files.cat(l) 

copy, software products.swinstall(lM) 

copydvagent () - copy device assignment structure .getdvagent(3) 

copylist () - copy a file into memory.copylist(3C) 

copysign functions.copysign(3M) 

copysign(), copysignf() - copysign functions.copysign(3M) 

copysignf (), copysign () - copysign functions.copysign(3M) 

copywin () - copy a region of window.copywin(3X) 

core - core image file format.core(4) 

core image file format.core(4) 

correct the time to synchronize the system clock .adjtime(2) 


HP-UX Release 11.0: October 1997 


Hewlett-Packard Company Index-23 
































































Index 
All Volumes 

Description Entry Name(Section) 

cos() - cosine function .cos(3M) 

cosd () - cosine function (degrees) .cosd(3M) 

cosdf () - cosine function (float, degrees) .cosd(3M) 

cosf () - cosine function (float) .cos(3M) 

cosh (), coshf () - hyperbolic cosine functions .cosh(3M) 

coshf (), cosh () - hyperbolic cosine functions .cosh(3M) 

cosine function, inverse hyperbolic.acosh(3M) 

cosine functions.cos(3M) 

cosine functions, hyperbolic .cosh(3M) 

cosine trigonometric function (degrees) .cosd(3M) 

count adjacent repeated lines in a file.uniq(l) 

count words, lines, and bytes or characters in a file.wc(l) 

cp - copy file, files, or directory subtree .cp(l) 

cpaci () - copy access control list (ACL) to another file .cpacl(3C) 

cpio archive format .cpio(4) 

cpio - copy file archives in and out.cpio(l) 

cpio - format of cpio archive.cpio(4) 

cpp - theC language preprocessor.cpp(l) 

cpset - install object files in binary directories.cpset(lM) 

CPU time used, report .clock(3C) 

cpu, set name of host .sethostname(2) 

crash dump acess library .Iibcrash(5) 

crash dump data, manipulate.crashutil(lM) 

crash dump descriptor, close.cr_close(3) 

crash dump information, retrieve .cr_info(3) 

crash dump of the operating system, save .savecrash(lM) 

crash dump, open for reading.cr_open(3) 

crash dump, read from .cr_read(3) 

crash dump, verify integrity of .cr_verify(3) 

crash dumps, configure system.crashconf(lM) 

crash dumps, configure system .crashconf(2) 

crash .glossary(9) 

crash, patch up damaged filesystem (generic).fsdb(lM) 

crash, patch up damaged HFS filesystem .fsdb_hfs(lM) 

crashconf - configure system crash dumps.crashconf(lM) 

crashconf () - configure system crash dumps .crashconf(2) 

crashutii - manipulate crash dump data .crashutil(lM) 

creat () - create a new file or rewrite an existing one.creat(2) 

creat64 () - file system API to support large files.creat64(2) 

create a directory file .mkdir(2) 

create a directory .mkdir(l) 

create a directory, special, or ordinary file .mknod(2) 

create a DOS directory .dosmkdir(l) 

create a makefile. mkmf(l) 

create a name for a temporary file.tmpnam(3S) 

create a new file.creat(2) 

create a new file or rewrite an existing one.creat(2) 

create a new key in thepubiickey database file.newkey(lM) 

create a new process.fork(2) 

create a new thread of execution .pthread_create(3T) 

create a pair of connected sockets.socketpair(2) 

create a socket .socket(2) 

create a special (device) file.mksf(lM) 

create a tags file.ctags(l) 

create a temporary file .tmpfile(3S) 

create a unique (usually temporary) file name.mktemp(3C) 

create an endpoint for communication .socket(2) 

create an interprocess channel .pipe(2) 

create and administer SCCS files.admin(l) 

create and monitor jobs .swjob(lM) 

create backup LVM volume group configuration file.vgcfgbackup(lM) 
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create empty administration file owned by adm with mode 664 .acctsh(lM) 

create file names.glob(3C) 

create interprocess communication identifier.ftok(3C) 

create logical volume in LVM volume group.Ivcreate(lM) 

create LVM volume group.vgcreate(lM) 

create message catalog file for modification .findmsg(l) 

create message files for use by gettxt () .mkmsgs(l) 

create NIS+credentials.nisaddcred(lM) 

createNIS+directories .nismkdir(l) 

create NIS+tablesfrom corresponding/etc files or NIS maps .nisaddent(lM) 

create or destroy a thread-specific data key.pthread_key_create(3T) 

create or rebuild Network I nformation Service database.ypmake(lM) 

create periodic accounting summary files.acctsh(lM) 

create physical volume for usein LVM volume group .pvcreate(lM) 

create Product Description Filefroman input .mkpdf(lM) 

create sendmai I alias file.sendmail(lM) 

create session and set process group ID .setsid(2) 

create special and FIFO files.mknod(lM) 

create the cat files for the manual .catman(lM) 

create user crontabfile.crontab(l) 

create zero-length file.cat(l) 

create zero-length file .cp(l) 

create zero-length file .null(7) 

create zero-length file.touch(l) 

create, distribute, install, monitor, and manage software.sd(5) 

create, remove directories in a path .mkdirp(3G) 

create, windows, functions.newwin(3X) 

create/open a message queue.mp_open(2) 

create/open a shared memory object .shm_open(2) 

creates database maps for sendmai I .makemap(lM) 

creates print objects.pdcreate(l) 

create„sysfiie - create a kernel system file.create_sysfile(lM) 

creating PAM sessions.pam_open_session(3) 

creation function, relative window .derwin(3X) 

credentials, NIS+, initializefor NIS+principals.nisclient(lM) 

crontab, batch, and at queuedescription file.queuedefs(4) 

crontabfile operations, user .crontab(l) 

crontab - user crontab file operations .crontab(l) 

CRT or line-printer output, format text file for.nroff(l) 

CRT terminal, record displayed output simultaneously in a file.script(l) 

CRT terminals, perusefileon.more(l) 

crto.o, gcrto.o, mcrto.o, frto.o, mfrto.o - execution startuproutines .crtO(3) 

crto.o, mcrto.o - C and Pascal execution startup routines .crtO(3) 

crypt - encode/decodefiles.crypt(l) 

crypto, setkeyO, setkey_r(), encrypt_r(), encrypt () - generate hashi ng encryption .crypt(3C) 

cr„ciose () - close a crash dump descriptor .cr_close(3) 

cr_info() - retrieve crash dump information .cr_info(3) 

cr_isaddr() - validate whether physical page number was dumped .cr_isaddr(3) 

cr_open() - open crash dump for reading.cr_open(3) 

cr_perror () - print a libcrash error or warming message.cr_perror(3) 

cr_read() - read from crash dump .cr_read(3) 

cr_uncompress () - uncompress a file in a crash dump.cr_uncompress(3) 

cr_verify() - verify i ntegrity of crash dump .cr_verify(3) 

CS-80 .glossary(9) 

C S/80 Cartridge Tape I/O Utility.tcio(l) 

CS/80 .glossary(9) 

csh - a shell (command interpreter) with C-likesyntax.csh(l) 

csplit - context split .csplit(l) 

ct - cartridge tape device access drivers.ct(7) 

ct - spawn getty to remote terminal (call terminal).ct(l) 

ctags - create a tags file.ctags(l) 
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ctermid() - generate file name for terminal .ctermid(3S) 

ctime and date, time zone adjustment tablefor .tztab(4) 

ctime (), ctime r () - convert clock () date and ti me to string.ctime(3C) 

cu - call another (UNIX) system; terminal emulator .cu(l) 

cube root functions.cbrt(3M) 

cue, set terminal characteristics for .cuegetty(lM) 

cue - HP Character-Terminal User Environment (CUE).cue(l) 

cuegetty - set terminal characteristics for cue .cuegetty(lM) 

current absolute system time, add a specific time interval to the .get_expiration_time(3T) 

current directory .glossary(9) 

current erase and line kill characters .erasewchar(3X) 

current events and system calls to be audited.setevent(2) 

current host system, set or display name of .hostname(l) 

current host, get an identifier for .gethostid(2) 

current host, get name of.gethostname(2) 

current HP-UX model, print name of.model(1) 

current locale, query numeric formatting conventions of.localeconv(3C) 

current page size, get.getpagesize(2) 

current process, get audit ID (aid()) for.getaudid(2) 

current process, set audit ID (aid()) for .setaudid(2) 

current process, suspend or resume auditing on.audswitch(2) 

current processes, list .ps(l) 

current SCCS file editing activity, print .sact(l) 

current state (X/OPEN TLI-XTI) .t_getstate(3) 

current status of the UUCP system .uusnap(lM) 

current system users, list .who(l) 

current terminal information.cur_term(3X) 

current terminal, get verbose description of.longname(3X) 

current user context, get and set .getcontext(2) 

current user id, print or display .whoami(l) 

current user, find the slot in the utmp () fileofthe.ttyslot(3C) 

current users and processes, list .whodo(lM) 

current valueof system-wide clock, get.getclock(3C) 

current window.curscr(3X) 

current working directory.glossary(9) 

current working directory, get path-name of.getcwd(3C) 

current working directory, get pathname of.getwd(3C) 

curscr () - current window .curscr(3X) 

Curses session, suspend.endwin(3X) 

curses window, scroll .scroll(3X) 

curses_intro - introduction to curses .curses_intro(3X) 

cursor and window coordinates, get additional .getbegyx(3X) 

cursor and window coordinates, get.getyx(3X) 

cursor to end of window, clear .clrtobot(3X) 

cursor, clear from it to end of line .clrtoeol(3X) 

cursor, output movement commands to the terminal .mvcur(3X) 

cursor, set the cursor mode.curs_set(3X) 

cursor, window location functions.move(3X) 

curs_set () - set the cursor mode.curs_set(3X) 

cur_term() - current terminal information.cur_term(3X) 

cuserid() - get character-string login name of the user.cuserid(3S) 

cut - cut out selected fields of each line in a file.cut(l) 

Cyclical Redundancy Check on a file.sum(l) 

c_coiwidth (), c_colwidth () - test for valid first byte in 16-bit character.nl_tools_16(3X) 

daemon debug utility used by DDFA software, outbound connection .ocdebug(lM) 

daemon for modifying Network Information Servicepasswd database.yppasswdd(lM) 

daemon .glossary(9) 

daemon that responds to SNMP requests.snmpd(lM) 

daemon to maintain the nis+password table in sync with the nis+trusted table .ttsyncd(lM) 

daemon used by DDFA software, outbound connection .ocd(lM) 

daemon, gateway routing.gated (1M) 
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daemon, Internet services .inetd(lM) 

daemon, IP multicast routing .mrouted(lM) 

daemon, killsthesendmail daemon .killsm(lM) 

daemon, lineprinter daemon for LP requests from remote systems.rlpdaemon(lM) 

daemon, network lock .lockd(lM) 

daemon, NIS+password update daemon .rpc.nispasswdd(lM) 

daemon, NIS+service .rpc.nisd(lM) 

daemon, password and group hashing and cashing.pwgrd(lM) 

daemon, PFS.pfsd(lM) 

daemon, point to point protocol .cp(l) 

daemon, system physical environment .envd(lM) 

daemon, timed-job execution .cron(lM) 

daemon, Uninterruptible Power System (UPS) monitor .ups mond(lM) 

daemon: audit-overflow monitor daemon .audomon(lM) 

daemons, NFS.nfsd(lM) 

daily accounting shell procedure.runacct(lM) 

daily system activity report package.sal(lM) 

damaged filesystem, patch up (generic) .fsdb(lM) 

damaged HFS filesystem, patch up .fsdb_hfs(lM) 

data allocation space of object files, print section sizes and .size(l) 

data and stack space, allocate then lock process into memory.datalock(SC) 

data base compiler, terminfo.tic(lM) 

data base of terminal-type for each tty port .ttytype(4) 

data base, terminfo, de-compile .untic(lM) 

Data Communications and Terminal Controller Device File Access software.ddfa(7) 

data encryption .glossary(9) 

data error indication (X/OPEN TLI-XTI) .t_rcvuderr(3) 

data from a file, read.read(2) 

data or expedited data over a connection (X/OPEN TLI-XTI).t_snd(3) 

data order for display/keyboard, convert file .forder(l) 

data order, convert string.strord(3C) 

data over connection, receive (X/OPEN TLI-XTI) .t_rcv(3) 

data path width (in bits), set .io_width_ctl(3l) 

data pointer for binary search tree, get .tsearch(3C) 

data returned by stat/fstat/istat system call .stat(5) 

data segment and shared memory, attach or detach .shmop(2) 

data segment space allocation, change.brk(2) 

data to a file, write.write(2) 

data to check the network, scatter.spray(3N) 

data transfer rate, inform system of required minimum I/O .io_speed_ctl(3l) 

data translation of ELF files .elf_xlate(3E) 

datatypes, basic integer .inttypes(5) 

data types, system primitives .types(5) 

data unitfrom remote transport provider user (X/OPEN TLI-XTI).t_rcvudata(3) 

data unit, send to transport user (X/OPEN TLI-XTI) .t_sndudata(3) 

data, expand or compress .compress(l) 

data, get character or word from a stream file.getc(3S) 

data, get wide character from a stream file .getwc(3C) 

data, lock in memory .plock(2) 

data: manipulate crash dump data.crashutil(lM) 

database access functions, NIS+.nis_db(3N) 

database and directory structure, Network Information Service.ypfiles(4) 

database converter, DFICP client.dhcpdb2conf(lM) 

database entry, mani pul ate device assignment .getdvagent(3) 

database entry, mani pul ate protected password.getprpwent(3) 

database entry, mani pul ate system default.getprdfent(3) 

database entry, mani pul ate terminal control .getprtcent(3) 

database file, trusted system device assignment .devassign(4) 

database files and directory structure, NIS+.nisfiles(4) 

database for public keys.pubiickey(4) 

database for the mail aliases file, rebuild .newaliases(lM) 
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database from NIS server to local node, transfer NIS.ypxfr(lM) 

database maps for sendmail, creating .makemap(lM) 

database subroutines (new multiple database version).ndbm(3X) 

database subroutines (old version - see also ndbm(3X)).dbm(3X) 

database, check internal consistency of Authentication .authck(lM) 

database, create or rebuild Network Information Service.ypmake(lM) 

database, daemon for modifying Network Information Servicepasswd.yppasswdd(lM) 

database, force propagation of a Network Information Service.yppush(lM) 

database, host names.hosts(4) 

database, make a Network Information System .makedbm(lM) 

database, network configuration .netconfig(4) 

database, network name.networks(4) 

database, pathalias, access and manage the .uupath(l) 

database, protocol name .protocols(4) 

database, relational, join two relations in .join(l) 

database, RPC program number .rpc(4) 

database, service name.services(4) 

database, termcap, emulation .tgetent(3X) 

databases, build and install Network I nformation Service.ypinit(lM) 

databases, security.authcap(4) 

datacomm line speed and terminal settings used by getty .gettydefs(4) 

datagram protocol, Internet user .UDP(7P) 

dataiock () - lock process into memory after allocating data and stack space.datalock(3C) 

date and ctime, ti me zone adjustment tablefor .tztab(4) 

dateandtime, convert to string.ctime(3C) 

dateand time, convert to string .strftime(3C) 

dateand time, convert to wide-character string.wcsftime(3C) 

dateand time, convert user format.getdate(3C) 

dateand time, get more precisely (Version 7 compatibility only) .ftime(2) 

dateand time, set via NTP.ntpdate(lM) 

date - display or set the system-dock dateand time.date(l) 

date, display current or set to new value.date(l) 

date, get system clock .gettimeofday(2) 

date, set .stime(2) 

daylight () - Daylight SavingsTimeflag.ctime(3C) 

dbmciose () - close currently open database(old single-data-base version) .dbm(3X) 

dbminit () - open a singledatabase(old single-data-base version) .dbm(3X) 

dbm clearerr () - reset error condition on named database.ndbm(3X) 

dbm ciose () - close an open database.ndbm(3X) 

dbm delete () - delete a database key and associated contents.ndbm(3X) 

dbm error () - error in reading or writing in a database.ndbm(3X) 

dbm fetch () - access a databaseentry under a key.ndbm(3X) 

dbm firstkey () - get first key in a database.ndbm(3X) 

dbm nextkey () - get next key in a database.ndbm(3X) 

dbm open () - open a database for access.ndbm(3X) 

dbm store () - store an entry under a key in a database.ndbm(3X) 

db add entry () - NIS+ database access functions .nis_db(3N) 

dbcheckpoint () - NIS+database access functions .nis_db(3N) 

db_create_tabie () - NIS+database access functions .nis_db(3N) 

db_destroy_tabie () - NIS+database access functions .nis_db(3N) 

db_f irstentry () - NIS+database access functions .nis_db(3N) 

db_f ree_resuit () - NIS+database access functions .nis_db(3N) 

dbinitialize () - NIS+database access functions .nis_db(3N) 

db_jList_entries () - NIS+database access functions .nis_db(3N) 

db next entry () - NIS+database access functions .nis_db(3N) 

db remove entry () - NIS+database access functions .nis_db(3N) 

db reset next entry () - NIS+database access functions .nis_db(3N) 

dbstandby () - NIS+database access functions .nis_db(3N) 

dbtabieexists () - NIS+database access functions .nis_db(3N) 

dbunioadtabie () - NIS+database access functions .nis_db(3N) 

dc - desk calculator.dc(l) 
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dec - control SCSI disk array read/write caching.dcc(lM) 

dcopy - copy HFS filesystem with compaction.dcopy(lM) 

dd - convert, reblock, translate, and copy a (tape) file.dd(l) 

ddfa - Data Communications and Terminal Controller Device File Access software.ddfa(7) 

DDFA software and Telnet port identification feature, dedicated ports file used by.dp(4) 

DDFA software, configuration file, used by .pcf(4) 

DDFA software, dedicated ports parser used by.dpp(lM) 

DDFA software, outbound connection daemon used by .ocd(lM) 

DDS tape cartridge, partition.mediainit(l) 

de-compile terminfo data base.untic(lM) 

dead, letter file .sendmail(lM) 

debug file system (generic) .fsdb(lM) 

debug HFS filesystem .fsdb_hfs(lM) 

debug utility used by DDFA software, outbound connection daemon .ocdebug(lM) 

debugger, VxFS filesystem.fsdb_vxfs(lM) 

debugger: absolute debugger .adb(l) 

debugger: assembler debugger.adb(l) 

debugger: object code debugger .adb(l) 

debugging tool, STREAMS debugging tool .strdb(lM) 

decimal ASCII string, convert long integer to .ltostr(3C) 

decimal equivalents: ASCI I character set.ascii(5) 

decimal library, packed, HP 3000-mode.hppac(3X) 

decode a file encoded by uuencode .uuencode(l) 

decode/encode files.crypt(l) 

decompose floating-point number.modf(3M) 

decrease physical extents allocated to LVM logical volume .Ivreduce(lM) 

decrypt and store secret key .keyiogin(l) 

decrypt/encrypt files .crypt(l) 

dedicated line, reserve for a purpose .ripoffline(3X) 

dedicated ports file used by DDFA software and Telnet port identification feature.dp(4) 

dedicated ports parser used by DDFA software.dpp(lM) 

default database entry, manipulate system.getprdfent(3) 

default database file, trusted system.default(4) 

default disk section sizes, calculate.disksecn(lM) 

default kernel files, update.kmupdate(lM) 

default - label default in switch statement .csh(l) 

default login shell, change.chsh(l) 

default message catalog, set.setcat(3) 

default search path.glossary(9) 

default stacksize, change.pthread_default_stacksize_np(3T) 

default - system default database file for a trusted system.default(4) 

default values: display NIS+default values .nisdefaults(l) 

default window .stdscr(3X) 

defauit_disk_ir tunable parameter.mount(lM) 

define additional severities.addsev(3C) 


define additional signal stack space.sigspace(2) 

define and describe audit system events .audeventstab(4) 

define I/O device interrupt (fault) conditions .io_on_interrupt(3l) 

define kernel process accounting output file or disable accounting .acct(lM) 

define label for formatting routines .setlabel(3) 

define what to do upon receipt of a signal .signal(2) 

define window coordinate transformation.mvderwin(3X) 


definition, display system.sysdef(lM) 

definitions, memory mapping.mman(5) 

definitions, regular expression and pattern matching notation .regexp(5) 

def_prog_mode () - save or restore program or shell terminal modes.def_prog_mode(3X) 

def shell mode () - save terminal modes as the "shell" state.def_prog_mode(3X) 

degree-valued arccosine functions.acosd(3M) 

degree-valued arcsine functions.asind(3M) 

degree-valued arctangent functions .atand(3M) 

degree-valued arctangent-and-quadrant functions .atan2d(3M) 
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degree-valued cosine functions.cosd(3M) 

degree-valued sinefunctions .sind(3M) 

degree-valued tangent functions.tand(3M) 

delay and insert capability, for terminal .has_ic(3X) 

delay command execution.at(l) 

delay mode, control input character delay mode.halfdelay(3X) 

delay output () - delay output .delay_output(3X) 

deich (), mvdeich (), mvwdeich (), wdeich () - delete character from a window .delch(3X) 

delete a directory.rmdir(l) 

delete a file or directory .rm(l) 

delete a group from the system.groupdel(lM) 

delete a node from a binary search tree.tsearch(3C) 

delete a user login from the system .userdel(lM) 

delete a window.delwin(3X) 

delete allocated signal stack space.sigspace(2) 

delete and modify user credentials for an authentication service.pam_setcred(3) 

delete DOS files or directories.dosrm(l) 

delete file .unlink(2) 

delete NIS+directories.nisrmdir(l) 

delete NIS+objects from the namespace.nisrm(l) 

delete or insert lines into a window .insdelln(3X) 

delete secret key stored with keyserv .keylogout(l) 

delete selected characters.tr(l) 

delete user crontab file.crontab(l) 

delete () - delete key and data under it (old single-data-base version) .dbm(3X) 

delete, add, or modify delete access control list entry.setaclentry(3C) 

delete, add, updatea kernel module.kminstall(lM) 

delete, copy, add, modify, or summarize file access control lists (ACLs) .chacl(l) 

delete-character features, hardware, enable or disable use of.idcok(3X) 

deleteln (), wdeleteln () - delete lines in window .deleteln(3X) 

deletes print objects.pddeletefl) 

deiscreen () - free storage associated with a screen .delscreen(3X) 

delta (change) to an SCCS file, make a.delta(l) 

delta commentary of an SCCS delta, change.cdc(l) 

delta from an SCCS file, remove a .rmdel(l) 

delta.glossary(9) 

delta - make a delta (change) to an SCCS file.delta(l) 

delwin () - delete a window.delwin(3X) 

del curterm(), restartterm (), set_curterm (), setupterm() - interfaces to 

terminfo database.del_curterm(3X) 

demon .glossary(9) 

deny or permit write(l) messages from other users to terminal .mesg(l) 

dependencies, list dynamic, of executable files or shared libraries .Idd(l) 

depot, modify software products target in root or.swmodify(lM) 

depots and roots, register or unregister.swreg(lM) 

deroff - remove nroff, tbl, and neqn constructs.deroff(l) 

derwin() - relativewindowcreation function .derwin(3X) 

DES encryption key, generate a .makekey(l) 

descend a directory hierarchy recursively, executing a function.ftw(3C) 

describe audio file.attributes(l) 

describe audit system events, define and .audeventstab(4) 

describe characteristics of a disk device.diskinfo(lM) 

description filefor at, batch, and crontab queues.queuedefs(4) 

description of common HP-UX terms.glossary(9) 

description of disk by its name, get .getdiskbyname(3C) 

description of HP-UX header file organization.stdsyms(5) 

description of supported languages.Iang(5) 

description, DOS InterchangeFormat .dosif(4) 

description, host name resolution.hostname(5) 

description, logical interchange format.Iif(4) 

description, secure internet services.sis(5) 
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Description 

description, verbose, of current terminal . 

descriptor file entry, get file system (BSD 4.2 compatibility only) . 

descriptor, close a file. 

descriptor, map stream pointer to file. 

descriptor: update an ELF descriptor . 

desk calculator . 

destroy a mutex attribute object . 

destroy a mutex . 

destroy a read-write lock attribute object . 

destroy a read-write lock. 

destroy a thread attribute object . 

destroy a thread-specific data key. 

destroy an unnamed semaphore. 

destroy mass storage data for security purposes (use -r option). 

destroy or initializea thread condition variable . 

destroy or initializea thread condition variableattributes object. 

detach a name from a STREAMS-based file descriptor . 

detach a STREAMS-based file descriptor . 

detach a thread to reclaim its resources when it terminates. 

detach shared memory from data segment . 

determine accessibility of a file. 

determine current signal stack space. 

determine file type . 

determine file type for ELF files. 

determine how last I/O read terminated . 

determine whether a screen has been refreshed . 

determine who is logged in on local network machines . 

determined processor IDs. 

devassign - trusted system device assignment database file . 

device (special) file, list an I/O . 

device (special) file, make. 

device (special) file, remove a. 

device (special) files, install . 

device access drivers, cartridge tape. 

device address. 

device and FIFO files, create . 

device assignment database entry, manipulate. 

device configuration and status, display LANO . 

device control commands, generic I/O . 

device driver, flexibleor "floppy" disk. 

device driver, PS/2 keyboard and mouse. 

device driver, SCSI direct access. 

device driver, SCSI media changer . 

device driver, SCSI sequential access. 

device driver: STREAMS passthrough driver. 

device drivers . 

device drivers in the system, list. 

device drivers, Small Computer System Interface (SCSI) . 

Device File Access software, Data Communications and Terminal Controller 

device file. 

device file, block mode terminal . 

device file, FIFO, make a . 

device files, network filesystem. 

device for interleaved paging and swapping, add swap. 

device for paging, enable. 

device. 

device I/O interrupt (fault) control . 

device ID to file path, map . 

device name. 

device numbers, header file of macros for handling. 

device special file, control character . 


Entry Name(Section) 

.longname(3X) 

.getfsent(3X) 

.close(2) 

.fileno(3S) 

.elf_update(3E) 

.dc(l) 

.pthread_mutexattr_init(3T) 

.pthread_mutex_init(3T) 

.pthread_rwlockattr_init(3T) 

.pthread_rwlock_init(3T) 

.pthread_attr_dinit(3T) 

.pthread_key_create(3T) 

.sem_destroy(2) 

.mediainit(l) 

.pthread_cond_init(3T) 

.pthread_condattr_init(3T) 

.fdetach(3C) 

.fdetach(lM) 

.pthread_detach(3T) 

.shmop(2) 

.access(2) 

.sigspace(2) 

.file(l) 

.elf_kind(3E) 

.io_get_term_reason(3l) 

.isendwin(3X) 

.rusers(l) 

pthread_processor_bind_np(3T) 

.devassign (4) 

.Issf(lM) 

.mksf(lM) 

.rmsf(lM) 

.insf(lM) 

.ct(7) 

.glossary (9) 

.mknod(lM) 

.getdvagent(3) 

.lanscan(lM) 

.ioctl(5) 

.floppy(7) 

.ps2(7) 

.scsi_disk(7) 

.autochanger(7) 

.scsi_tape(7) 

.cione(7) 

.(see special files) 

.Isdev(lM) 

.scsi(7) 

.ddfa(7) 

.glossary (9) 

.blmode(7) 

.mkfifo(3C) 

.nfs(7) 

.swapon(2) 

.swapon(lM) 

.glossary (9) 

.io_on_interrupt(3l) 

.devnm(3) 

.devnm(lM) 

.mknod(5) 

.ioctl(2) 
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device special files, introduction .intro(7) 

device, control a SCSI .scsictl(lM) 

device, control terminal (Bell Version 6 compatibility) .stty(2) 

device, describe characteristics of a disk.diskinfo(lM) 

device, who is currently using.fuser(lM) 

device: STREAMS device.isastream(3C) 

device; update, install, or remove boot programs from a disk.mkboot(lM) 

devices - fileof driver information for insf, mksf, lssf.devices(4) 

devnm - device name.devnm(lM) 

devnm () - map device ID to file path .devnm(3) 

df - report number of free CDFS, FIFS, or NFS filesystem disk blocks.df_hfs(lM) 

df - report number of free disk blocks on a VxFS filesystem.df_vxfs(lM) 

df - report number of free file system disk blocks (generic) .df(lM) 

df vxfs - report number of free disk blocks on a VxFS filesystem.df_vxfs(lM) 

DFICP client database converter.dhcpdb2conf(lM) 

DFICP elements of bootpd, command line tool .dhcptools(lM) 

DFICP support script, system configuration .auto parms(lM) 

dhcpdb2conf - DFICP client database converter.dhcpdb2conf(lM) 

dhcptoois - command line tool for DFICP elements of bootpd .dhcptools(lM) 

diagO - diagnostic interfaceto I/O subsystem .diag0(7) 

diagnostic information, dynamic linking process.dlerror(3C) 

diagnostic interface to I/O subsystem .diag0(7) 

diagnostic messages, collect to form system error log .dmesg(lM) 

diagnostics.fcmsutil(lM) 

diagnostics .fcutil(lM) 

diagnostics, local area network.lanadmin(lM) 

dial () - establish an out-bound terminal line connection .dial(3C) 

dialer description file format, ppp .ppp.Dialers(4) 

dialups, d_passwd - dialup security control .dialups(4) 

dialups file.login(l) 

diff, diffh - differential file comparator.diff(l) 

diff between sorted files; reject/select common lines.comm(l) 

diff fileto an original, applying.patch(l) 

diff, big .bdiff(l) 

diff3 - three-way differential file comparison .diff3(l) 

difference function, positive.fdim(3M) 

differences among three files.diff3(1) 

differences between files, show side-by-side.sdiff(l) 

differences between large files, find.bdiff(l) 

differences between two files.diff(l) 

differences between two files, mark .diffmk(l) 

differential file comparator.diff(l) 

dif fink - mark differences between files.diffmk(l) 

difftimeO - difference between two calendar ti me values .ctime(3C) 

dir - format of directories .dir(4) 

dircmp - directory comparison .dircmp(l) 

direct access device driver, SCSI .scsi_disk(7) 

direct disk device access drivers .disk(7) 

directories to export to NFS clients.exports(4) 

directories to export to PFS clients .pfs_exports(5) 

directories to NFS clients, export and unexport.exportfs(lM) 

directories, binary, install object files in.cpset(lM) 

directories, export or unexport to PFS clients.pfs_exportfs(lM) 

directories: create, remove directories in a path .mkdirp(3G) 

directories: creating NIS+directories.nismkdir(l) 

directories: list the contents.nisls(l) 

directory and file structures, statd .sm(4) 

directory clean-up, uucp spool .uudeanup(lM) 

directory entries and directory streams, format of .dirent(5) 

directory file, make.mknod(2) 

directory file, remove a .rmdir(2) 
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directory format .dir(4) 

directory.glossary(9) 

directory hierarchy, recursively descend a, executing a function.ftw(3C) 

directory name, print working.pwd(l) 

directory object, NIS+, update the public keys .nisupdkeys(lM) 

directory pointer array, sort a .scandir(3C) 

directory service, Internet user name.whois(l) 

directory stream, directory and associated, open for access .directory(3C) 

directory streams and directory entries, format of .dirent(5) 

directory streams, HP-UX, format of.ndir(5) 

directory structure and database files, NIS+.nisfiles(4) 

directory structure, Network Information Service database and.ypfiles(4) 

directory, change working.cd(l) 

directory, get entries in a file-system-independent format .getdirentries(2) 

directory, get pathname of current working.getwd(3C) 

directory, move directory subtree and files to another directory .mv(l) 

directory, move multiplefiles to another directory.mv(l) 

directory, rename directory .mv(l) 

directory, scan a.scandir(3C) 

directory, symbolic links between directories, create .In(l) 

directory: access, open, or close a directory and associated directory stream .directory(3C) 

directory: change root directory .chroot(2) 

directory: change root directory for a command.chroot(lM) 

directory: change working directory .chdir(2) 

directory: compare contents of two directories.dircmp(l) 

directory: compress files in a directory.compress(l) 

directory: copy directory subtree and files to another directory .cp(l) 

directory: copy multiplefiles to a directory .cp(l) 

directory: create a directory .mkdir(l) 

directory: create a DOS directory .dosmkdir(l) 

directory: expand compressed files in a directory.compress(l) 

directory: get path-name of current working directory .getcwd(3C) 

directory: list contents of directory.Is(l) 

directory: list contents of DOS directories .dosls(l) 

directory: make a directory file.mkdir(2) 

directory: move a directory (requires super-user) .mvdir(lM) 

directory: print working directory name.pwd(l) 

directory: read portable archive.pax(l) 

directory: remove directory.rmdir(l) 

directory: remove DOS files or directories.dosrm(l) 

directory: remove entry.unlink(2) 

directory: scan a directory .scandir(3C) 

directory: search directory tree for files.find(l) 

directory: search for named file in named directories .pathfind(3G) 

directory: write portable archive.pax(l) 

dirent .h - format of directory streams and directory entries .dirent(5) 

dirname, basename - extract portions of path names .basename(l) 

dirname() - return path name of parent directory.basename(3C) 

dirs - print the directory stack .csh(l) 

disable accounting or define kernel process accounting output file.acct(lM) 

disable - disableLP printers.enable(l) 

disableor enable abbreviation of function keys.keypad(3X) 

disableor enableflush on interrupt .intrflush(3X) 

disableor enable I/O interrupts for the associated eid() .io_interrupt_ctl(3l) 

disableor enable process accounting .acct(2) 

disableuseof certain terminal capabilities.filter(3X) 

disabl^enable block during read .nodelay(3X) 

disable/enable immediate terminal refresh .immedok(3X) 

disable/enable meta-keys.meta(3X) 

disable/enable newline translation.nl(3X) 

disable/enable queue flushing .noqiflush(3X) 
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Description Entry Name(Section) 

disabl^enable terminal echo.echo(3X) 

disable/enable use of hardware insert- and delete-character features .idcok(3X) 

discard file (bit bucket).null(7) 

discard input.flushinp(3X) 

disconnect information (X/OPEN TLI-XTI).t_rcvdis(3) 

disconnect request, send user-initiated (X/OPEN TLI-XTI).t_snddis(3) 

disk accounting data of VxFS file system , disk usage by user ID.diskusg(lM) 

disk accounting data, disk usage by user ID .diskusg(lM) 

disk accounting, perform .acctsh(lM) 

disk array, configuration table.arraytab(4) 

disk array, configurea logical unit(LUN).cfl(lM) 

disk array, configuring.newarray(lM) 

disk array, control read/write caching.dcc(lM) 

disk array, describe characteristics of.arrayinfo(lM) 

disk array, display status of.dsp(lM) 

disk array, download firmware to .dlf(lM) 

disk array, formatting a LUN for .for mat(1M) 

disk array, repair LUN parity information.rpr(lM) 

disk array, scan LUNsfor parity consistency.pscan(lM) 

disk array, scan LUNsfor parity consistency.scn(lM) 

disk array, search system for .arrayscan(lM) 

disk array, set spindlesynchronization state of drives in .sss(lM) 

disk array: set physical drive parameters for.spd(lM) 

disk blocks (generic), report number of free file system.df(lM) 

disk blocks on a VxFS filesystem .df_vxfs(lM) 

disk blocks, report number of free (Berkeley version) .bdf(lM) 

disk blocks, report number of free, CDFS, HFS, or NFS filesystem.df_hfs(lM) 

disk clusters, DOS, report number of free .dosdf(l) 

disk description by its name, get .getdiskbyname(3C) 

disk description file.disktab(4) 

disk device driver, flexible or "floppy".floppy(7) 

disk device, describe characteristics of a .diskinfo(lM) 

disk device, direct access drivers .disk(7) 

disk device; update, install, or remove boot programs from a.mkboot(lM) 

disk - direct disk device access drivers .disk(7) 

disk directory format .dir(4) 

disk layout of VxFS filesystem, upgrade .vxupgradeflM) 

disk quota status of specified file system, determine.fsclean(lM) 

disk quotas.quota(5) 

disk quotas, manipulate.quotactl(2) 

disk quotas, summarize for a file system.repquota(lM) 

disk section sizes, calculate default.disksecn(lM) 

disk space management.Ivm(7) 

disk space, DOS, report amount of available.dosdf(l) 

disk space, recover .freedisk(lM) 

disk storage space, preallocate.prealloc(l) 

disk storage, preallocate fast.prealloc(2) 

disk usage accounting records, create.acct(lM) 

disk usage and limits, display .quota(l) 

disk usage by login name, compute.acct(lM) 

disk usage, generate disk accounting data by user ID.diskusg(lM) 

disk usage, generate disk accounting data of VxFS file system by user ID .vxdiskusg(lM) 

disk usage, summarize.du(l) 

disk, flush buffers to.sync(2) 

disk, flush unwritten system buffers to .sync(lM) 

disk, SCSI direct access device driver.scsi_disk(7) 

disk, synchronizea file's in-core state with its state on.fsync(2) 

disk: periodically flush unwritten system buffers to disk .syncer(lM) 

diskinfo - descri be characteristics of a disk device.diskinfo(lM) 

diskless (remote) boot server.rbootd(lM) 

diskless client configuration information file .info(4) 
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disksecn - calculate default disk section sizes.disksecn(lM) 

disktab - disk description file.disktab(4) 

diskusg - generate disk accounting data by user ID .diskusg(lM) 

dismount (unmount) a file system (generic) .mount(lM) 

dismount (unmount) CDFS filesystems.mountcdfs(lM) 

dismount (unmount) HFS filesystems.mount_hfs(lM) 

dismount (unmount) NFS filesystems.mount_nfs(lM) 

display (print) arguments.echo(l) 

display (print) formatted arguments.printf(l) 

display address resolution.arp(lM) 

display and modify variables in the stable storage.setboot(lM) 

display and update information about top processes on system.top(l) 

display audit information as requested by parameters .audisp(lM) 

display call graph execution profile data .gprof(l) 

display contents of theNIS+transaction log .nislog(lM) 

display current system-dock dateandtime.date(l) 

display disk usageand limits .quota(l) 

display elm user and system aliases.elmalias(l) 

display fileon soft-copy terminals.pg(l) 

displayfileonCRT terminals.more(l) 

display information about computer system .uname(l) 

display information about LVM logical volumes .Ivdisplay(lM) 

display information about LVM volumegroups .vgdisplay(lM) 

display information about physical volumes in LVM volume group.pvdisplay(lM) 

displayjob information and remove jobs.swjob(lM) 

display LAN device configuration and status.lanscan(lM) 

display message in standard format .pfmt(3C) 

display monitor profile data.prof(l) 

display name of current host system .hostname(l) 

display Network Information Service domain name.domainname(l) 

display network status.netstat(l) 

display NIS+default values.nisdefaults(l) 

display NIS+error messages.niserror(l) 

display NIS+error messages .nis_error(3N) 

display NI S+tables and objects .niscat(l) 

display or change event or system call audit status.audevent(lM) 

display or set audit file information .audsys(lM) 

display STREAMS structures.strdb(lM) 

display system and user login data.logins(lM) 

display system definition.sysdef(lM) 

display user login data.listusers(lM) 

display/keyboard data order, convert file.forder(l) 

displayed CRT terminal output, record, simultaneously in a file.script(l) 

displaysformatted message on standard error and console.fmtmsg(3C) 

displaysthe last part of the mail log.mtail(lM) 

distance function, Euclidean (hypotenuse) .hypot(3M) 

distribute, install, monitor, create, and manage software.sd(5) 

Distributed Print Service, creates print objects.pdcreate(l) 

Distributed Print Service, enables printers to accept jobs and logs to log .pdenable(l) 

Distributed Print Service, lists selected attribute values.pdls(l) 

Distributed Print Service, removes all jobs from thespecified object .pdclean(l) 

Distributed Print Service, stops printers from accepting jobs and logs from logging .pddisable(l) 

div(), ldiv() - integer division and remainder .div(3C) 

divide mirrored LVM logical volumeinto two logical volumes.Ivsplit(lM) 

division and remainder, integer .div(3C) 

divpage - divide pages for two-sided printing .Ipfilter(l) 

diclose () - close a shared object.dlclose(3C) 

did. si - dynamic loader.did.si(32) 

did. si - dynamic loader.dld.sl(5) 

did. si - dynamic loader.dld.sl(64) 

dierror () - get diagnostic information from dynamic linking process.dlerror(3C) 
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Description Entry Name(Section) 

dif - download firmware to an HP SCSI disk array.dlf(lM) 

diget () - retrieve information on loaded module (program or shared library).dlget(3C) 

digetname () - retrieve name of load module.dlgetname(3C) 

dimodinfo () - retrieve information on loaded module (program or shared library).dlmodinfo(3C) 

diopen () - open a shared object .dlopen(3C) 

disym () - get address of symbol in shared object .dlsym(3C) 

dmesg - collect system diagnostic messages to form error log .dmesg(lM) 

dmpxit - dump iconv translation tables to a readable format .dmpxlt(l) 

dn comp() - resolver routines.resolver(3N) 

dn expand() - resolver routines.resolver(3N) 

do nothing and return zero or non-zero exit status.true(l) 

documentation, list of orderable HP-UX .manuals(5) 

documents, format and print using the mm macros.mm(l) 

documents, MM macro package for formatti ng.mm(5) 

dodisk - perform disk accounting.acctsh(lM) 

domain name server, Internet.named(lM) 

domain name server, send signalsto .sig named(lM) 

domain name, set or display Network Information Service.domainname(l) 

domain protocol, local communication.UNIX(7P) 

domain, get or set name of current NIS .getdomainname(2) 

domain, initializea NIS+domain.nissetup(lM) 

domainname - set or display NIS domain name.domainname(l) 

DOS files: change attributes of a DOS file .doschmod(l) 

DOS files: convert DOS fileto HP-UX ASCII format.dos2ux(l) 

DOS files: convert HP-UX ASCII fileto DOS format.dos2ux(l) 

DOS files: copy to or from .doscp(l) 

DOS files: create a DOS directory .dosmkdir(l) 

DOS files: list contents of DOS directories .dosls(l) 

DOS files: remove DOS files or directories .dosrm(l) 

DOS files: report number of free DOS disk clusters.dosdf(l) 

dos2ux, ux2dos - convert ASCII fileformat .dos2ux(l) 

doschmod - change attributes of a DOS file.doschmod(l) 

doscp - copy to or from DOS files.doscp(l) 

dosdf - report number of free DOS disk clusters .dosdf(l) 

DOSIF - DOS I nterchangeFormat description .dosif(4) 

dosii, dosis - list contents of DOS directories.dosls(l) 

dosis, dosii - list contents of DOS directories.dosls(l) 

dosmkdir - make a DOS directory.dosmkdir(l) 

dosrm, dosrmdir - remove DOS files or directories.dosrm(l) 

dosrmdir, dosrm - remove DOS files or directories.dosrm(l) 

dot.glossary(9) 

dot-dot.glossary(9) 

dot-oh file.glossary(9) 

dot-oh format . glossary(9) 

dot-oh .glossary(9) 

double-precision number, convert string to .strtod(3C) 

double-precision number, convert string to long.strtold(3C) 

double-precision number, convert wide character string to.wcstod(3C) 

doupdate(), refresh (), wnoutrefresh (), wrefresh () - refresh windows and lines . doupdate(3X) 

downshifting.glossary(9) 

dp - dedicated ports file used by DDFA software and Telnet port identification feature .dp(4) 

dpp - dedicated ports parser used by DDFA software.dpp(lM) 

drand48 (), erand48 () - generate double-precision pseudo-random numbers .drand48(3C) 

draw borders from complex characters and renditions .border_set(3X) 

draw borders from complex characters and renditions.box_set(3X) 

draw borders from single-byte characters and renditions.border(3X) 

draw borders from single-byte characters and renditions.box(3X) 

draw lines from complex characters and renditions.hline_set(3X) 

draw lines from single-byte characters and renditions .hline(3X) 

driver .(see also special files) 

driver information file for insf, mksf, issf.devices(4) 
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driver, block mode terminal .blmode(7) 

driver, flexible or "floppy" disk device.floppy(7) 

driver, IP network tunnel driver.tun(4) 

driver, PS/2 keyboard and mouse devices.ps2(7) 

driver, SCSI device control device.scsi_pt(7) 

driver, SCSI direct access device.scsi_disk(7) 

driver, SCSI media changer device .autochanger(7) 

driver, SCSI pass-through device .scsi_ctl(7) 

driver, SCSI sequential access device.scsi_tape(7) 

driver: STREAMS Administrative Driver.sad(7) 

driver: STREAMS log driver .strlog(7) 

drivers in the system, list device.Isdev(lM) 

drivers, Small Computer System Interface (SCSI) device.scsi(7) 

drivers: cartridge tape device access.ct(7) 

drivers: direct disk device access drivers .disk(7) 

drivers: HP-HIL cooked keyboard.hilkbd(7) 

drivers: HP-HIL device driver.hil(7) 

drivers: raster frame-buffer display device access .framebuf(7) 

dsp - display status of an HP SCSI disk array.dsp(lM) 

du - summarize disk usage.du(l) 

dump and restore protocol module, remote magnetic tape.rmt(lM) 

dump file in octal or hexadecimal format .od(l) 

dump file system information .dumpfs(lM) 

dump iconv translation tables to a readable format.dmpxlt(l) 

dump - incremental filesystem dump (for backups).dump(lM) 

dump information contained in object files.elfdump(l) 

dump unwritten system buffers to disk.sync(lM) 

dump unwritten system buffers to disk periodically .syncer(lM) 

dump volume, prepareLVM logical volume to be .Ivlnboot(lM) 

dump volume, remove LVM logical volumelink.Ivrmboot(lM) 

dump window to and reload window from a file.getwin(3X) 

dump, crash dump acess library .Iibcrash(5) 

dump, incremental filesystem, across network.vxdump(lM) 

dump, incremental filesystem, local .vxdump(lM) 

dumpfs - dump file system information .dumpfs(lM) 

dumpmsg - create message catalog file for modification.findmsg(l) 

dup() - duplicatean open file descriptor .dup(2) 

dup 2 () - duplicatean open file descriptor to a specific slot.dup2(2) 

duplicatea window.dupwin(3X) 

duplicatean open file descriptor.dup(2) 

duplicatean open file descriptor to a specific slot.dup2(2) 

duplicateentries in a table, eliminate.lsearch(3C) 

dupwin() - duplicatea window.dupwin(3X) 

dynamic dependencies of executablefiles, list.Idd(l) 

dynamic file system swapping.swapon(2) 

Dynamic Host Configuration Protocol (DHCP).dhcpdb2conf(lM) 

dynamic linking process, diagnostic information .dlerror(3C) 

dynamic loader.dld.sl(64) 

dynamic loader.glossary(9) 

dynamic loader, binding behavior .Id(l) 

dynamically loadable kernel modules, change global search path.modpath(2) 

dynamically loaded kernel module, get information .modstat(2) 

d_passwd - dialup security control .dialups(4) 

e - extended line-oriented text editor .ex(l) 

echo - echo (print) arguments.csh(l) 

echo - echo (print) arguments .echo(l) 

echo - echo (print) arguments .ksh(l) 

echo - echo (print) arguments.sh-bourne(l) 

echo - echo (print) arguments .sh-posix(l) 

echo packets .ping(lM) 

Echo Request packet, send FibreChannel Lightweight Protocol .pong(lM) 
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echo single-bytecharacter and rendition to a window and refresh .echochar(3X) 

echo() - enable/disable terminal echo.echo(3X) 

echo, suppress while reading password from terminal .getpass(3C) 

echochar() - echo single-byte character and rendition to a wi ndow and refresh .echochar(3X) 

ECHO REQUEST packets.ping(lM) 

echowchar () - writea complex character and immediately refresh the window .echo_wchar(3X) 

ecvt (), fcvt () - convert floating-point number to string.ecvt(3C) 

ed - line-oriented text editor .ed(l) 

edata () - first address beyond initialized program data region .end(3C) 

edit - beginner's line-oriented text editor.ex(l) 

editthepasswordfileusingvi editor.vipw(lM) 

edit user quotas.edquota(lM) 

editing activity, print current SCCS file.sact(l) 

editor and command history for interactive programs input .ied(l) 

editor, audio.seeaudio(5) 

editor: extended line-oriented text editor .ex(l) 

editor: extended screen-oriented text editor.vi(l) 

editor: line-oriented .ed(l) 

editor: streaming (non-interactive) text editor.sed(l) 

edquota - edit user quotas.edquota(lM) 

effective access rights to a file, get a user’s .getaccess(2) 

effective and real user I Ds, set .setreuid(2) 

effective current user id, print or display.whoami(l) 

effective group ID .glossary(9) 

effective or real user or group ID, get .getuid(2) 

effective user ID .glossary(9) 

effective, real, and/or saved user or group IDs, set.setresuid(2) 

egrep - search a file for a pattern .grep(l) 

EISA configuration tool .eisaconfig(lM) 

eisa_config - EISA configuration tool .eisa config(lM) 

electronic address router.pathalias(l) 

electronic mail, screen-oriented interface.elm(l) 

element, convert floating-point number to string or string array.ecvt(3C) 

ELF - executable and linkingformat object files.elf(3E) 

ELF files, set fill byte for .elf_fill(3E) 

ELF library error handling .elf_error(3E) 

elf () - object file access library .elf(3E) 

elf32_f size () - return the size of an object file type for elf32 files.elf_fsize(3E) 

eif32 getehdr - retrieve class-dependent object file header for ELF files .elf_getehdr(3E) 

elf32 getphdr () - retrieve class-dependent program header tablefor ELF files.elf_getphdr(3E) 

eif32 getshdr () - retrieve class-dependent section header for ELF files.elf_getshdr(3E) 

elf32_newphdr () - retrieve class-dependent program header tablefor ELF files.elf_getphdr(3E) 

elf32_xiatetof () - class-dependent data translation of ELF files.elf_xlate(3E) 

elf32_xiatetom() - class-dependent data translation of ELF files.elf_xlate(3E) 

elf64 fsize () - return thesizeof an object filetypefor elf64fiIes.elf_fsize(3E) 

elf 64 getphdr () - retrieve class-dependent program header tablefor ELF files.elf_getphdr(3E) 

elf 64 getshdr () - retrieve class-dependent section header for ELF files.elf_getshdr(3E) 

elf 64 newphdr () - retrieve class-dependent program header tablefor ELF files.elf_getphdr(3E) 

elf64_xiatetof () - class-dependent data translation of ELF files.elf_xlate(3E) 

elf64_xiatetom() - class-dependent data translation of ELF files.elf_xlate(3E) 

elfdump - dump information contained in object files.elfdump(l) 

elf begin () - make a file descriptor, for ELF files.elf_begin(3E) 

elfcnti () - control a file descri ptor for ELF files .elf_cntl(3E) 

elf end() - finish using an ELF object file.elf_end(3E) 

elf errmsg () - ELF library error handling.elf_error(3E) 

elf errno () - ELF library error handling .elf_error(3E) 

elff ill - set fill byte for ELF files.elf_fill(3E) 

elff lagdata () - mani pulate flags for ELF files.elf_flag(3E) 

elff lagehdr () - mani pulate flags for ELF files.elf_flag(3E) 

eiffiageif () - mani pulate flags for ELF files.elf_flag(3E) 

elff lagphdr () - mani pulate flags for ELF files.elf_flag(3E) 
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elf f lagscn () - manipulate flags ELF files .elf_flag(3E) 

elff lagshdr () - manipulate flags for ELF files.elf_flag(3E) 

elf getarhdr () - retrieve archive member header for ELF files.elf_getarhdr(3E) 

elf getarsym () - retrieve archive symbol tablefor ELF files.elf_getarsym(3E) 

elf getbase () - get the base offset for an object file .elf_getbase(3E) 

elf get data () - manipulate section data for ELF files.elf_getdata(3E) 

elf getident () - retrieve file identification data for ELF files.elf_getident(3E) 

elf getscn() - get section information for ELF files .elf_getscn(3E) 

elfhash () - compute hash value for ELF files.elf_hash(3E) 

elf kind () - determi ne file type for ELF files.elf_kind(3E) 

elf ndxscn() - get section information for ELF files .elf_getscn(3E) 

elf newdata () - manipulate section data for ELF files.elf_getdata(3E) 

elf newscn() - get section information for ELF files .elf_getscn(3E) 

elf next () - provide sequential archive member access for ELF files .elf_next(3E) 

elf nextscn() - get section information for ELF files.elf_getscn(3E) 

elf rand () - random archive member access for ELF files.elf_rand(3E) 

elf rawdata () - manipulate section data for ELF files.elf_getdata(3E) 

eif rawfile () - retrieve uninterpreted file contents for ELF files .elf_rawfile(3E) 

elf strptr () - make a string pointer for ELF files.elf_strptr(3E) 

elf update () - updatean ELF descriptor .elf_update(3E) 

elf version () - coordinate E LF library and application versions.elf_version(3E) 

eliminate .so's from nroff input.soelim(l) 

eliminatea directory.rmdir(l) 

el i min ate a file or directory.rm(l) 

eliminateadjacent repeated lines in a file.uniq(l) 

eliminateduplicateentries in a table.lsearch(3C) 

eliminate multi pie adjacent blank lines, reduce to single blank line.ssp(l) 

elm - process electronic mail through a screen-oriented interface.elm(l) 

elm user and system aliases, verify and display.elmalias(l) 

eimaiias - display and verify elm user and system aliases .elmalias(l) 

empty administration file owned by adm with mode 664, create .acctsh(lM) 

emulate /etc/termcap access routines.termcap(3X) 

Emulation module, STREAMS pty .ptem(7) 

emulation of termcap database.tgetent(3X) 

emulator, IBM 3179G/3192G, 3270, 3777terminal .sna(l) 

emulator, terminal; call another (UNIX) system .cu(l) 

enabledevice or filesystem for paging.swapon(lM) 

enable - enableLP printers.enable(l) 

enableor disableblock during read .nodelay(3X) 

enableor disableflush on interrupt.intrflush(3X) 

enableor disable I/O i nterrupts for the associated eld () .io_interrupt_ctl(3l) 

enableor disableimmediateterminal refresh .immedok(3X) 

enableor disable process accounting.acct(2) 

enableor disable use of hardware insert- and delete-character features.idcok(3X) 

enableSRQ lineon H P-l B, allow interface to.hpib_rqst_srvce(3l) 

enable/disable abbreviation of function keys.keypad(3X) 

enable/disable meta-keys.meta(3X) 

enable/disable newline translation.nl(3X) 

enabl^disable queue flushing.noqiflush(3X) 

enable/disable terminal echo.echo(3X) 

enables paused objects to resume operation .pdresume(l) 

enables printers to accept jobs and logs to log .pdenable(l) 

encodea binary filefor transmission by mailer.uuencode(l) 

encode/decodefiles.crypt(l) 

encrypt () - generate hashingencryption .crypt(3C) 

encrypt/decrypt files .crypt(l) 

encryption key, generate a DES .makekey(l) 

encryption keys file format, ppp.ppp.Keys(4) 

encryption keys, server for storing .keyserv(l) 

encryption on large strings, generate hashing.bigcrypt(3C) 

encryption, hashing, generate.crypt(3C) 
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encryption, password .crypt(3C) 

encrypt_r() - generate hashing encryption .crypt(3C) 

end locations of allocated regions in program .end(3C) 

end network host entry.gethostent(3N) 

end of line, clear from cursor to end of line.clrtoeol(3X) 

end part of a file, get lines from .tail(l) 

end protocol entry.getprotoent(3N) 

end service entry .getservent(3N) 

end - terminateforeach or whileloop.csh(l) 

end() - first address beyond uninitialized program data region .end(3C) 

end-of-file .glossary(9) 

enddvagent () - free memory and close file .getdvagent(3) 

endexportent () - access exported file system information .exportent(3N) 

endfsento - dose file system descri ptor file .getfsent(3X) 

endgrento - close currently open group () file.getgrent(3C) 

endhostent () - end network host entry.gethostent(3N) 

endhostent_r () - end network host entry (thread-safe) .gethostent(3N) 

endmntent () - close file system description file.getmntent(3X) 

endnetconfig () - get /etc7netconfig entry corresponding to NETPATH component .getnetpath(3N) 

endnetconfig () - get network configuration data base entry.getnetconfig(3N) 

endnetent (): get network entry.getnetent(3N) 

endnetgrent () - get network group entry .getnetgrent(3C) 

endpoint for communication, create an .socket(2) 

endprdf ent () - mani pul ate system default databaseentry .getprdfent (3) 

endprotoent () - end protocol entry.getprotoent(3N) 

endprotoent__r () - end protocol entry (thread-safe) .getprotoent(3N) 

endprpwent () - mani pul ate protected password databaseentry .getprpwent(3) 

endprtcent () - manipulateterminal control databaseentry .getprtcent(3) 

endpwent () - close currently open password file.getpwent(3C) 

endservent () - end service entry .getservent(3N) 

endservent_r () - end service entry (thread-safe).getservent(3N) 

endspento - close currently open secure password file .getspent(3C) 

endspwent () - close currently open secure password file.getspwent(3X) 

endsw - terminate switch statement .csh(l) 

endusersheii () - close legal user shells file.getusershell(3C) 

endutento - close currently open utmp () file.getut(3C) 

endutent_r() - close currently open utmp () file.getut(3C) 

endutxent () - close currently open utmpx () file.getutx(3C) 

endwin () - suspend Curses session.endwin(3X) 

entries from a directory, get in a file-system-independent format.getdirentries(2) 

entries from namelist, get .nlist(3C) 

entries in a table, eliminateduplicate.lsearch(3C) 

entries, directory, format of .dirent(5) 

entry format, ioconfig.ioconfig(4) 

entry format, user accounting files btmp (), utmp(), andwtmpo .utmp(4) 

entry from group () file, get.getgrent(3C) 

entry from password file, get.getpwent(3C) 

entry from secure password file, get .getspent(3C) 

entry from secure password file, get .getspwent(3X) 

entry, get filesystem descriptor file (BSD 4.2 compatibility only) .getfsent(3X) 

entry, get RPC.getrpcent(3C) 

entry, get, set, or end network host .gethostent(3N) 

entry, get, set, or end protocol .getprotoent(3N) 

entry, get, set, or end service.getservent(3N) 

entry, mani pul ate protected password database.getprpwent(3) 

entry, mani pul ate system default database.getprdfent(3) 

entry, manipulateterminal control database.getprtcent(3) 

entry, network group, get or set.getnetgrent(3C) 

entry, print out a manual; find manual information by keywords .man(l) 

entry, write password file.putpwent(3C) 

env - set environment for command execution.env(l) 
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envd - system physical environment daemon .envd(lM) 

environ - user environment variables.environ(5) 

Environment (CUE), HP Character-Terminal User.cue(l) 

environment daemon, system physical .envd(lM) 

environment for command execution, set.env(l) 

environment.glossary(9) 

environment list, search for value of specified variablename.getenv(3C) 

environment macros and functions, floating-point .fenv(5) 

environment variable, search environment list for valueof.getenv(3C) 

environment variable, tz .date(l) 

environment variables, user .environ(5) 

environment, change or add valueto.putenv(3C) 

environment, clear the process.clearenv(3C) 

environment, login shell script to set up user's .profile(4) 

environment, print out the .printenv(l) 

environment, save/restore stack for non-local goto.setjmp(3C) 

Environment, SoftBench Software Development.softbench(l) 

environment: getting floating-point.fegetenv(3M) 

environment: saving floating-point .feholdexcept(3M) 

environment: setting floating-point .fesetenv(3M) 

environment: updating floating-point .feupdateenv(3M) 

EOF .glossary(9) 

EOI mode for HP-IB file, control .hpib_eoi_ctl(3l) 

Epoch .glossary (9) 

eraseand reinitialize mass storage media (use-r option) .mediainit(l) 

erase character.erasewchar(3X) 

erase character, single-byte.erasechar(3X) 

erase terminal screen .clear(l) 

erase () - dear a window.clear(3X) 

erasechar() - single-byte erase character.erasechar(3X) 

erasewchar () - current erase character.erasewchar(3X) 

erf () - error function .erf(3M) 

erfc () - complementary error function .erf(3M) 

errno () - error indicator for system calls.errno(2) 

errno () - system error messages.perror(3C) 

error function .erf(3M) 

error handling, ELF library .elf_error(3E) 

error indicator for system calls.errno(2) 

error information from unit data error indication (X/OPEN TLI-XTI).t_rcvuderr(3) 

error log files, remove outdated STREAMS error log files.strclean(lM) 

error log, collect system diagnostic messages to form .dmesg(lM) 

error message file, extract error messages from C source into.mkstr(l) 

error message function (X/OPEN TLI-XTI).t_error(3) 

error message string, get PAM .pam_strerror(3) 

error message, produce (X/OPEN -XTI) .t_strerror(3) 

error messages from the STREAMS log driver .strerr(lM) 

error messages, display NIS+.nis_error(3N) 

error messages, extract from C source into a file.mkstr(l) 

error messages, system.perror(3C) 

error messages: displaying .niserror(l) 

error or warming message, libcrash, print.cr_perror(3) 

error processing with t_rcvuderr(3) .t_sndudata(3) 

error status, asynchronous I/O .aio_error(2) 

errors, find spelling.speil(l) 

errors, library routines for server side remote procedure call errors .rpc_svc_err(3N) 

establish an out-bound terminal line connection .dial(3C) 

establish connection with another transport user (X/OPEN TLI-XTI).t_connect(3) 

establish time limit for I/O operations.io_timeout_ctl(3l) 

etext () - first address beyond program text region .end(3C) 

EUC, set and get code widths for Idterm.eucset(l) 

Euclidean distance (hypotenuse) function .hypot(3M) 
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eucset - set and get EUC code widths for Idterm.eucset(l) 

eval - read arguments as shell input and execute result .csh(l) 

eval - read arguments as shell input and execute resulting commands.ksh(l) 

eval - read arguments as shell input and execute resulting commands .sh-bourne(l) 

eval - read arguments as shell input and execute resulting commands.sh-posix(l) 

evaluate arguments as an expression .expr(l) 

evaluate condition for true or false.test(l) 

event on transport endpoint, look at current event (X/OPEN TLI-XTI).t_look(3) 

event or system call audit status, change or display.audevent(lM) 

event trace messages to standard output, write STREAMS event trace messages.strace(lM) 

events and system calls currently being audited, get .getevent(2) 

events and system calls to be audited .setevent(2) 

events, audit system, define and describe .audeventstab(4) 

ex - extended line-oriented text editor .ex(l) 

examine and change blocked signals .sigprocmask(2) 

examine and change signal action .sigaction(2) 

examine and change signal action.sigwait(2) 

examine and change the signal mask of thecallingthread .pthread_sigmask(3T) 

examine pending signals.sigpending(2) 

exception flags: getting floating-point .fegetexceptflag(3M) 

exception flags: setting floating-point .fesetexceptflag(3M) 

exception trap enable bits: getting.fegettrapenable(3M) 

exception trap enable bits: setting .f esettr a pen a bl e( 3M) 

exceptions: clearing floating-point.feclearexcept(3M) 

exceptions: raisingfloating-point .feraiseexcept(3M) 

exceptions: testing floating-point.fetestexcept(3M) 

exchange, portable archive .pax(l) 

exec - execute command without creating new process .csh(l) 

exec - execute command without creating new process.ksh(l) 

exec - execute command without creating new process.sh-bourne(l) 

exec - execute command without creating new process.sh-posix(l) 

execl (), execle (), execlp (), execv (), execve (), execvp () - execute a file . exec(2) 

executable and linkingformat object files (ELF).elf(3E) 

executable file, generate from object files and libraries.Id(l) 

executable files in directory, list.Is(l) 

executable, prepare for faster program start-up.fastbind(l) 

execute a command on a remote host.rcmd(3N) 

execute a command, measure time used to.time(l) 

execute a file.exec(2) 

execute a function, descending a directory tree.ftw(3C) 

execute a regular expression against a string .regcmp(3X) 

execute a simple command.command(l) 

execute command on a remote host .on(l) 

execute command with constructed large argument list(s).xargs(l) 

execute commands at a later time .at(l) 

execute commands in background .at(l) 

execute from a remote shell .remsh(l) 

execute HALGOL programs .opx25(lM) 

execute process with POSIX real-time priority.rtsched(l) 

execute process with real-time priority.rtprio(l) 

execute remote uucp or uux command requests on local system .uuxqt(lM) 

execute, and compile, regular expressions.re_comp(3X) 

executing program, send signal .ki 11 (2) 

execution of a thread, continue, resume, or suspend .pthread_resume_np(3T) 

execution of commands, UNIX system to UNIX system.uux(l) 

execution profile data, display call graph .gprof(l) 

execution profile, prepare.monitor(3C) 

execution server, remote.rexecd(lM) 

execution server, RPC-based remote.rexd(lM) 

execution startup routines, C, Pascal, and FORTRAN .crt0(3) 

execution time profile.profil(2) 
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execution, commands, set environment for .env(l) 

execution, suspend for a time interval .sleep(l) 

execution, suspend for an interval .usleep(2) 

execution, suspend for interval .sleep(3C) 

existing file, truncate to zero for rewriting.creat(2) 

exit - exit shell with exit status.csh(l) 

exit - exit shell with exit status.ksh(l) 

exit - exit shell with exit status.sh-bourne(l) 

exit - exit shell with exit status.sh-posix(l) 

exit status, do nothing and return zero or non-zero .true(l) 

exit (), exit () - terminate process .exit(2) 

exit, register a function to be called at .atexit(2) 

exp (), expf () - exponential functions .exp(3M) 

exp2 () - base-2 exponential function .exp2(3M) 

expand, unexpand - expand tabs to spaces, and vice versa .expand(l) 

expand or compress data .compress(l) 

expand text line to specified length.newform(l) 

expands the sendmaiI aliases, recursively.expand alias(l) 

expand alias - recursively expands the sendmai I aliases.expandalias(l) 

expansions, perform word .wordexp(3C) 

expedited data over a connection (X/OPEN TLI-XTI).t_snd(3) 

expf (), exp() - exponential functions .exp(3M) 

explicit load of shared libraries.shl_load(3X) 

explicit locking of streams within a multi-thread application.flockfile(3S) 

expmi () - exponential functions .expml(3M) 

exponent and mantissa, split double-precision number into.frexp(3M) 

exponent of a floating-point number, load .ldexp(3M) 

exponent, radix-independent .logb(3M) 

exponential function, base-2 .exp2(3M) 

exponential functions.exp(3M) 

exponential functions .expml(3M) 

export an LVM volume group and its associated logical volumes .vgexport(lM) 

export and unexport directories to PFS clients .pfs_exportfs(lM) 

export directories to NFS clients .exportfs(lM) 

export directories, to PFS clients .pfs_exports(5) 

export - export variable names to environment of subsequent commands .ksh(l) 

export - export variable names to environment of subsequent commands.sh-bourne(l) 

export - export variable names to environment of subsequent commands .sh-posix(l) 

export to NFS clients, directories to.exports(4) 

exported filesystem information, access.exportent(3N) 

exportent () - access exported file system information .exportent(3N) 

exportfs - export and unexport directories to NFS clients .exportfs(lM) 

exports - directories to export to NFS clients.exports(4) 

expr - evaluate arguments as an expression .expr(l) 

expression matching routines, regular.regcomp(3C) 

expression or string, search a file for a.grep(l) 

expression, regular, and pattern matching notation definitions.regexp(5) 

expression, regular, compile and match routines .regexp(3X) 

expression, regular, compile or execute against a string .regcmp(3X) 

expressions, compile and execute regular expressions.re_comp(3X) 

exrt_unregister () - library routines for registering servers .rpc_svc_reg(3N) 

extend an LVM volume group by adding physical volumes .vgextend(lM) 

extend filesystem size .extendfs(lM) 

extend H FS filesystem size.extendfs_hfs(lM) 

extend VxFS filesystem size .extendfs_vxfs(lM) 

extended general terminal interface.termiox(7) 

extendfs - extend filesystem size.extendfs(lM) 

extendfs_hfs - extend H FS filesystem size.extendfs_hfs(lM) 

extendfs vxfs - extend VxFS filesystem size .extendfs_vxfs(lM) 

extent attributes (VxFS), get .getext(lM) 

extent attributes(VxFS), set .setext(lM) 
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extract error messages from C source into a file .mkstr(l) 

extract mantissa and exponent from double-precision number.frexp(3M) 

extract non-repeated lines from a file.uniq(l) 

extract portions of path names .basename(l) 

extract selected fields of each line in a file.cut(l) 

extract strings from C programs to implement shared strings.xstr(l) 

flcrash dump, uncompress a file in .cr_uncompress(3) 

flfile: uncompress a file in a crash dump .cr_uncompress(3) 

fluncompress a file in a crash dump .cr_uncompress(3) 

fabs () - absolute value functions.fabs(3M) 

fabsf () - absolute value functions.fabs(3M) 

facilities, interprocess communication, report status.ipcs(l) 

facilities, software signal .sigvector(2) 

factor, primes - factor a number, generate large primes.factor(l) 

factor a number, generate large primes.factor(1) 

fallback mechanism .service.switch(lM) 

false - do nothing and return non-zero exit status.true(l) 

fals^trueevaluatecondition for .test(l) 

family, Internet protocol .inet(7F) 

fast disk storage, preallocate.prealloc(2) 

fast find: list file names and statisticsfor VxFS filesystem.ff_vxfs(lM) 

fastbind - prepare an incomplete executable for faster program start-up.fastbind(l) 

faster program start-up.fastbind(l) 

faster tape I /O .ftio(l) 

fastmaii - quick batch mail interface.fastmail(l) 

fattach() - attach a STREAMS file descriptor.fattach(3C) 

fault (interrupt) conditions, definefor I/O device.io_on_interrupt(3l) 

fault, generate an IOT .abort(3C) 

fbackup - back up selected files or groups of files .fbackup(lM) 

fc - edit and execute previous command .ksh(l) 

fc - edit and execute previous command .sh-posix(l) 

f chdir () - change working directory .chdir(2) 

f chmod () - change file mode access permissions.chmod(2) 

fchown() - change owner and group of a file.chown(2) 

f close () - flush buffer then close stream.fclose(3S) 

fcmsutii - fibrechannel diagnostic utility.fcmsutil(lM) 

fcnti - file control options .fcntl(5) 

fcntio - open-file control .fcntl(2) 

fcpaci () - copy access control list (ACL) to another file .cpacl(3C) 

fcutii -fibrechannel diagnostic utility .fcutil(lM) 

fcvt (), ecvt () - convert floating-point number to string.ecvt(3C) 

FDDI (PCI) interface status, show.fddi pci admin(lM) 

fddi - Fiber Distributed Data I nterfaceTools.fddi(7) 

FDDI interface status, show.fddistat(lM) 

FDDI interface tools .fddi(7) 

FDDI interface, initialize.fddiinit(lM) 

FDDI interface, stop and reset .fddistop(lM) 

FDDI network interfaces, initializeand connect all system .fddisetup(lM) 

FDDI network, connect to the .fddiinit(lM) 

FDDI ring, list characteristics of nodes on.fddinet(lM) 

FDDI SNMP subagent deamon .fddisubagtd(lM) 

fddiinit - connect to the FDDI network .fddiinit(lM) 

fddinet - list characteristics of nodes on FDDI ring .fddinet(lM) 

fddipciadmin - show PCI FDDI i nterface status.fddi pci admin(lM) 

fddisetup - initializeand connect all system FDDI network interfaces.fddisetup(lM) 

fddistat - show FDDI interface status.fddistat(lM) 

fddistop - stop and reset FDDI interface.fddistop(lM) 

fddisubagtd - FDDI SNMP subagent deamon .fddisubagtd(lM) 

f detach - detach a name from a STREAMS file descriptor.fdetach(3C) 

fdetach - detach a STREAMS-based file descriptor .fdetach(lM) 

f dim () - positive difference function .fdim(3M) 
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fdopen () - associatea stream with an open file descriptor .fopen(3S) 

feclearexcept () - clear floating-point exceptions .feclearexcept(3M) 

fegetenv() - get floating-point environment .fegetenv(3M) 

fegetexceptflag () - get floating-point exception flags .fegetexceptflag(3M) 

fegetflushtozero () - get floating-point underflow mode .fegetflushtozero(3M) 

fegetround() - get floating-point rounding mode.fegetround(3M) 

fegettrapenabie () - get exception trap enable bits.fegettrapenable(3M) 

f ehoidexcept () - save floating-point environment .feholdexcept(3M) 

feof () - check for end-of-file error on stream .ferror(3S) 

feraiseexcept () - raisefloating-point exceptions .feraiseexcept(3M) 

ferror () - check for I/O error on stream.ferror(3S) 

fesetenv() - set floating-point environment .fesetenv(3M) 

fesetexceptflag () - set floating-point exception flags.fesetexceptflag(3M) 

fesetflushtozero () - set floating-point underflow mode.fesetflushtozero(3M) 

fesetround() - set floating-point rounding mode .fesetround(3M) 

fesettrapenabie () - set exception trap enable bits .fesettrapenable(3M) 

fetch() - access data under a key (old single-data-base version) .dbm(3X) 

fetestexcept () - test floating-point exceptions .fetestexcept(3M) 

feupdateenv() - updatefloating-point environment .feupdateenv(3M) 

ff - fast find: list file names and statisticsfor VxFS filesystem.ff_vxfs(lM) 

ff - list file names and statisticsfor filesystem (generic) .ff(lM) 

ff - list file names and statisticsfor HFS filesystem .ff_hfs(lM) 

fflush () - flush buffer without closing stream.fclose(3S) 

ffs () - BSD find first set bit .memory(3C) 

ff_vxfs - fast find: list file names and statisticsfor VxFS filesystem.ff_vxfs(lM) 

fgetacl () - get access control list (ACL) information.getacl(2) 

fgetc () - get character or word from a stream file.getc(3S) 

fgetgrent () - get next entry in group () -file-formatted input stream .getgrent(3C) 

fgetpos () - save file position indicator for a stream.fgetpos(3S) 

fgetpos64 () - file system API to support large files .fgetpos64(2) 

fgetpwent () - get next entry in password-file-formatted input stream.getpwent(3C) 

fgets (), gets () - get a string from a standard input stream .gets(3S) 

fgetspwent () - get next entry in secure password-file-formatted input stream .getspwent(3X) 

fgetwc() - get wide character from a stream file.getwc(3C) 

fgetwc_uniocked () - get wide character from a stream file.getwc(3C) 

fgetws () - get a wide string from a stream file .fgetws(3C) 

fgrep - search a filefor a specific string (fast algorithm) .grep(l) 

Fiber Distributed Data Interface, FDDI .fddi(7) 

fibrechannel diagnostic utility.fcmsutil(lM) 

fibrechannel diagnostic utility.fcutil(lM) 

FibreChannel Lightweight Protocol Echo Request packet, send .pong(lM) 

Fibrechannel Light Weight Protocol, show network status.Iwpstat(lM) 

fields of each line in a file, cut out (extract) selected .cut(l) 

FIFO (named pipe) special files, make .mkfifo(l) 

FIFO files, create.mknod(lM) 

FIFO scheduling policy.rtsched(2) 

FIFO special file.glossary(9) 

FIFO special file, make a.mkfifo(3C) 

fileaccessand modification times, set or update.utime(2) 

fileaccessand modification times, set .utimes(2) 

file access mode.glossary(9) 

fileaccess permissions.glossary(9) 

File Access software, Data Communications and Terminal Controller Device.ddfa(7) 

file and data formats, audio.seeaudio(5) 

file archiver, tape.tar(l) 

file control options for open files.fcntl(5) 

file copy, public UNIX system to UNIX system .uuto(l) 

file copy, remote.rcp(l) 

file copy, remote.rcp(l) 

file creation (permissions) mask, set and get.umask(2) 

file creation, set access permissions mode mask for .umask(l) 
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file descriptor . glossary(9) 

file descriptor, make, for ELF files.elf_begin(3E) 

file descriptor, map stream pointer to .fileno(3S) 

file descriptor: attach a STREAMS file descriptor.fattach(3C) 

file descriptor: detach a name from a STREAMS-based file descriptor.fdetach(3C) 

file descriptor: detach a STREAMS-based file descriptor.fdetach(lM) 

file descriptor: duplicatean open file descriptor.dup(2) 

file descriptor: duplicatean open file descriptor to a specific slot .dup2(2) 

file descriptor: STREAMS device.isastream(3C) 

file descriptor: STREAMS-based pipe.isastream(3C) 

file - determine file type .file(l) 

file distri bution to remote hosts.rdist(l) 

file editing activity, print current SCCS .sact(l) 

fileentry get filesystem description .getmntent(3X) 

fileentry, get filesystem descriptor (BSD 4.2 compatibility only) .getfsent(3X) 

filefor FIPDPS gateway printers, configuration.pdgwcfg.conf(4) 

filefor localedef scripts, symbolictranslation.charmap(4) 

filefor rexec () and ftp security.netrc(4) 

filefor theSNMP agent configuration .snmpd.conf(4) 

file format and other information for auditing.audit(4) 

file format for keysh softkeys.softkeys(4) 

fileformat, <pwd.h> password file.passwd(4) 

fileformat, pppauthentication.ppp.Auth(4) 

fileformat, ppp dialer description .ppp.Dialers(4) 

fileformat, ppp encryption keys.ppp.Keys(4) 

fileformat, ppp neighboring systems description.ppp.Systems(4) 

fileformat, ppp packet filter specification .ppp.Filter(4) 

fileformat, ppp physical device description .ppp.Devices(4) 

fileformat, translatehost tableto nameserver.hosts_to_named(lM) 

fileformat: common archive files.ar(4) 

fileformat: compiled terminfo fileformat.term(4) 

fileformat: core image files .core(4) 

fileformat: disk description fileformat .disktab(4) 

fileformat: per-process accounting files.acct(4) 

fileformat: Product Description File.pdf(4) 

fileformat: protected password database.prpwd(4) 

fileformat: Revision Control System (RCS) files.rcsfile(4) 

fileformat: SCCS fileformat .sccsfile(4) 

fileformat: terminal control database.ttys(4) 

fileformat: text fileformat specification .fspec(4) 

fileformat: user accounting file entry .utmp(4) 

file formats, introduction.intro(4) 

file.glossary (9) 

file group class.glossary(9) 

file hierarchy . glossary(9) 

file identification data for ELF files, retrieve.elf_getident(3E) 

file link: soft (symbolic) link .symlink(4) 

file locking, provide semaphores and record locking on files.lockf(2) 

file mode, change access permissions.chmod(l) 

file mode, change access permissions.chmod(2) 

file name generation function.glob(3C) 

filename .glossary(9) 

file name of controlling terminal, generate.ctermid(3S) 

file name portability .glossary(9) 

filenames and statistics for FH F S filesystem, list .ff_hfs(lM) 

file names and statistics for VxFS file system .ff_vxfs(lM) 

file names for file system, list (generic).fF(lM) 

file names, long, convert a file system to allow .convertfs(lM) 

file offset.glossary(9) 

file on remote node, get file handlefor .getfh(2) 

file or anonymous memory region, initializesemaphore in mapped .msem_init(2) 
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file or anonymous region, remove semaphore in mapped .msem_remove(2) 

file or file structure, determine which processes are using.fuser(lM) 

file other class .glossary(9) 

file owner class.glossary(9) 

file path, map device ID to .devnm(3) 

file permission bits .glossary(9) 

file perusal filter for CRT terminals .more(l) 

file perusal filter for soft-copy terminals .pg(l) 

file pointer.glossary(9) 

filepointer: move read/write file pointer .Iseek(2) 

file position indicator for a stream, save or restore.fgetpos(3S) 

file serial number .glossary(9) 

file size in words, lines, and bytes or characters .wc(l) 

file size limits and break value, get or set.ulimit(2) 

file status flags .glossary(9) 

file status, get .fstat(2) 

file structures, statd directory and .sm(4) 

file syntax, gated configuration .gated.conf(4) 

file system (generic), construct .mkfs(lM) 

filesystem (generic), construct new.newfs(lM) 

filesystem (HFS), construct a new .newfs_hfs(lM) 

filesystem (HFS), construct .mkfs_hfs(lM) 

filesystem administration command .fsadm(lM) 

filesystem administration command .fsadm_hfs(lM) 

filesystem administration commands, configuration and binary files.fs_wrapper(5) 

file system API s to support large files .creat64(2) 

file system API s to support large files.fgetpos64(2) 

file system clean at last system shutdown, test for .fsclean(lM) 

file system consistency check and interactive repair .fsck(lM) 

file system consistency check and interactive repair (generic) .fsck(lM) 

file system control .fsctl(2) 

filesystem debugger (generic) .fsdb(lM) 

filesystem debugger (HFS) .fsdb_hfs(lM) 

filesystem debugger, VxFS.fsdb_vxfs(lM) 

file system description file entry .getmntent(3X) 

file system disk blocks (generic), report number of free.df(lM) 

file system disk blocks, report number of free CDFS, HFS, or NFS.df_hfs(lM) 

file system for paging, enable .swapon(lM) 

filesystem .glossary(9) 

filesystem information, access exported.exportent(3N) 

filesystem information, dump .dumpfs(lM) 

filesystem mount statistics, local .rmtab(4) 

filesystem mounting table, static.pfs_fstab(5) 

file system name space: attach a STREAMS file descriptor .fattach(3C) 

file system quota consistency checker, VxFS .quotacheck vxfs(lM) 

file system quota consistency checker, generic .quotacheck(lM) 

filesystem quotas, turn on and off.quotaon(lM) 

file system size, extend .extendfs(lM) 

file system size, extend HFS .extendfs_hfs(lM) 

filesystem size, extend VxFS .extendfs_vxfs(lM) 

file system statistics, get .statfs(2) 

file system statistics, get .statfsdev(3C) 

filesystem statistics, get.statvfsdev(3C) 

filesystem swapping.swapon(2) 

file system type info, get.sysfs(2) 

file system type, determine.fstyp(lM) 

filesystem, check and repair VxFS .fsck_vxfs(lM) 

filesystem, compare with Product Description File.pdfck(lM) 

filesystem, construct VxFS.mkfs_vxfs(lM) 

filesystem, copy HFS with compaction.dcopy(lM) 

filesystem, damaged, patch up (generic) .fsdb(lM) 
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filesystem, damaged, patch up (HFS) . fsdb_hfs(lM) 

filesystem, dump across network . vxdump(lM) 

file system, generate pathnames from inode numbers for VxFS . ncheck_vxfs(lM) 

filesystem, get mounted filesystem statistics. ustat(2) 

filesystem, incremental dump (for backups). dump(lM) 

filesystem, list file names and statistics (generic) . ff(lM) 

filesystem, list file names and statistics for (generic) . ff(lM) 

filesystem, list file names and statistics for HFS . ff_hfs(lM) 

file system, list file names and statistics for VxFS. ff_vxfs(lM) 

filesystem, local dump . vxdump(lM) 

filesystem, mount an LOFS . mountJofs(lM) 

filesystem, mount and unmount VxFS . mount_vxfs(lM) 

filesystem, mount . mount(2) 

filesystem, mount or unmount (generic) . mount(lM) 

filesystem, mount . vfsmount(2) 

filesystem, perform Network FileSystem mount to remote . vhe_u_mnt(lM) 

filesystem, portable, PFS . pfs(4) 

filesystem, repair VxFS . fsck_vxfs(lM) 

file system, report free disk blocks on VxFS. df_vxfs(lM) 

filesystem, restore incrementally, local or across network . vxrestore(lM) 

filesystem, restore incrementally, local or across network . restore(lM) 

filesystem: backup or archive the file system . backup(lM) 

filesystem: construct new VxFS filesystem. newfs_vxfs(lM) 

file system: convert a file system to allow long file names. convertfs(lM) 

filesystem: display disk usage and limits quota . quota(l) 

filesystem: filesystem hierarchy. hier(5) 

file system: file system vol ume format . fs(4) 

file system: get file system descriptor file entry (BSD 4.2 compatibility only) . getfsent(3X) 

filesystem: mounted file system table. mnt±ab(4) 

filesystem: optimize an existing HFS filesystem. tunefs(lM) 

file system: static information about file systems. fstab(4) 

filesystem: summarize quotas . repquota(lM) 

filesystem: tune an existing HFS filesystem. tunefs(lM) 

filesystem: unmount a filesystem. umount(2) 

file systems with label checking, copy. vol copy (1M) 

file systems with label checking, copy. volcopy_hfs(lM) 

filesystems, automatically mount NFS. automount(lM) 

filesystems, CD-ROM, mount and unmount. pfs mount(lM) 

filesystems, keep track of remotely mounted . mount(3N) 

filesystems, mount and unmount CDFS . mountcdfs(lM) 

filesystems, mount and unmount HFS. mount_hfs(lM) 

filesystems, mount and unmount multiple . mountall(lM) 

filesystems, mount and unmount NFS. mount_nfs(lM) 

file times update. glossary(9) 

file transfer program. ftp(l) 

file transfer program, trivial . tftp(l) 

file transfer program, XMODEM-protocol . umodem(l) 

file transfer protocol server . ftpd(lM) 

file transfer protocol server, trivial. tftpd(lM) 

file tree, walk, executing a function . ftw(3C) 

filetypefor ELF files, determine. elf_kind(3E) 

file used by DDFA software and Telnet port identification feature, dedicated ports. dp(4) 

file's in-core state with its state on disk, synchronize a. fsync(2) 

file, aliases file for sendmail . aliases(5) 

file, change file mode access permissions. chmod(2) 

file, change owner or group . chown(l) 

file, change system configuration. ch_rc(lM) 

file, configuration, for pluggableauthentication module . pam.conf(4) 

file, context-dependent . chmod(l) 

file, context-dependent . chmod(2) 

file, create a kernel system. create_sysfile(lM) 
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file, create message catalog file for modification .findmsg(l) 

file, create special (device) .mksf(lM) 

file, create special and FIFO .mknod(lM) 

file, determine accessibility .access(2) 

file, directory, remove.rmdir(2) 

file, driver: driver information for insf, mksf, issf .devices(4) 

file, dump window to and reload window from .getwin(3X) 

file, for screen, input/output functions .scr_dump(3X) 

file, generate a formatted message catalog .gencat(l) 

file, get a user's effective access rights to a .getaccess(2) 

file, get file status.stat(2) 

file, get file status.statvfs(2) 

file, group: get entry from group () file.getgrent(3C) 

file, hidden .chmod(l) 

file, hidden .chmod(2) 

file, inetd configuration.inetd.conf(4) 

file, inetd optional security .inetd.sec(4) 

file, link additional name to an existing.Iink(2) 

file, link existing file to a new file name.In(l) 

file, LVM physical volume group information .Ivmpvg(4) 

file, make a directory, special, or ordinary .mknod(2) 

file, make a symbolic link.symlink(2) 

file, open for reading or writing .open (2) 

file, password: get entry from password file.getpwent(3C) 

file, password: get entry from secure password file.getspent(3C) 

file, password: get entry from secure password file.getspwent(3C) 

file, print out mail in the incoming mailbox.prmail(l) 

file, read data from .read(2) 

file, remove a special (device).rmsf(lM) 

file, resolver configuration .resolver(4) 

file, security for ftpd(lM) .ftpusers(4) 

file, send the contents of a file through a socket.sendfile(2) 

file, stream, get character or data word from a stream file .getc(3S) 

file, stream: buffered binary input/output to a stream file.fread(3S) 

file, stream: convert file to stream; open or re-open a stream file.fopen(3S) 

file, stream: get wide character from a stream file.getwc(3C) 

file, stream: open or re-open a stream file; convert file to stream .fopen(3S) 

file, stream: reposition or get pointer for I/O operations on a stream file .fseek(3S) 

file, synchronize a mapped .msync(2) 

file, used by DDFA software, configuration .pcf(4) 

file, utmp (), of the current user, find the slot in the.ttyslot(3C) 

file, validatean SCCS file .val(l) 

file, Virtual Flome Environment information .vhe_list(4) 

file, write data .write(2) 

file-name suffix conventions.suffix(5) 

file: accessutmpx() file .getutx(3C) 

file: access wtmp() or utmp () file .getut(3C) 

file: assign buffering to a stream file .setbuf(3S) 

file: change file mode access permissions.chmod(l) 

file: change owner and group .chown(2) 

file: change the name of a file.rename(2) 

file: close a file descriptor .close(2) 

file: control a file descriptor for ELF files.elf_cntl(3E) 

file: convert binary file to ASCII for transmission by mailer .uuencode(l) 

file: copy a file into memory .copylist(3C) 

file: copy access control list (ACL) to another file.cpacl(3C) 

file: create a name for a temporary file.tmpnam(3S) 

file: create a new file or rewrite an existing one .creat(2) 

file: create a temporary file.tmpfile(3S) 

file: create zero-length file .cat(l) 

file: create zero-length file.cp(l) 
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file: create zero-length file.null(7) 

file: create zero-length file.touch(l) 

file: decode a file encoded by uuencode.uuencode(l) 

file: delete .unlink(2) 

file: discard file (bit bucket).null(7) 

file: execute a file .exec(2) 

file: get the base offset for an object file.elf_getbase(3E) 

file: header file for future applications.portal(5) 

file: issue (/etc/issue) identification file format .issue(4) 

file: main memory and kernel memory image file.mem(7) 

file: make a unique (usually temporary) filename.mktemp(3C) 

file: null file (bit bucket) .null(7) 

file: object fileaccess library.elf(3E) 

file: open-file control routines.fcntl(2) 

file: read from file, stream, or character string with formatted input conversion.scanf(3S) 

file: receive next message from a STREAMS file.getmsg(2) 

file: remove a file.remove(3C) 

file: remove nroff/troff, tbl, and neqn constructs from .deroff(l) 

file: return the size of an object file type for elf32 or elf64 files .elf_fsize(3E) 

file: rewrite an existing file .creat(2) 

file: search for named file in named directories.pathfind(3G) 

file: special (device) files.(see special files) 

file: truncate a file to a specified length .truncate(2) 

file: truncate an existing file to zero for rewriting .creat(2) 

file: user accounting information file.utmpx(4) 

filename patterns, match .fnmatch(3C) 

filename: detach a STREAMS-based file descriptor.fdetach(lM) 

fileno () - map stream pointer to file descriptor .fileno(3S) 

files or records, move magnetic tape forward or backward by.mt(l) 

files, accounting, search and print .acctcom(lM) 

files, accounting: convert process accounting files to ASCI I text format .acctprc(lM) 

files, accounting: merge or add total accounting files.acctmerg(lM) 

files, accounting: print session record filecreated by acctconi.acctsh(lM) 

files, accounting: summarize process accounting files created by acctprci.acctprc(lM) 

files, administer and create SCCS files.admin(l) 

files, audit, set or get .audctl(2) 

files, C header, generate .rpcgen(l) 

files, change name of a file.mv(l) 

files, configuration and binary, filesystem administration .fs_wrapper(5) 

files, Cyclical Redundancy Check on a file.sum(l) 

files, find the printable strings in an object or other binary file .strings(l) 

files, format and print.pr(l) 

files, install special (device) .insf(lM) 

files, move directory subtree and files to another directory .mv(l) 

files, movefileto new location .mv(l) 

files, move multiplefiles to another directory .mv(l) 

files, object code: find ordering relation for files in an object code library.lorder(l) 

files, object code: install in binary directories.cpset(lM) 

files, object code: optimum sequence for object codefiles in a library, find.lorder(l) 

files, overwrite file with an existing file.mv(l) 

files, print checksum and block count of a file.sum(l) 

files, remove outdated STREAMS error log files.strclean(lM) 

files, rename directory.mv(l) 

files, rename file.mv(l) 

files, search a filefor a string or expression.grep(l) 

files, send copy of standard output to specified file.tee(l) 

files, send to system log .logger(l) 

files, text: format text filefor CRT or line-printer output.nroff(l) 

files, user configuration files for pluggableauthentication modules.pam_user.conf(4) 

files: accounting summary files, create periodic .acctsh(lM) 

files: add linenumber in front of each linein a file .nl(l) 
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back up selected files or groups of files .fbackup(lM) 

big file scanner .bfs(l) 

break a singlefile into multiplefiles.split(l) 

change or reformat a text file.newform(l) 

check nroff/troff files.checknr(l) 

compare two files and mark differences .diffmk(l) 

compare two files and show differences side-by-side.sdiff(l) 

compare two files.cmp(l) 

compare two versions of an SCCS file .sccsdiff(l) 

compress data in a file.compress(l) 

compress files in a directory .compress(l) 

context split .csplit(l) 

convert DOS fileto HP-UX ASCII fileformat .dos2ux(l) 

convert file keyboard/display data order .forder(l) 

convert HP-UX ASCII fileto DOS fileformat .dos2ux(l) 

copy directory subtree and files to another directory.cp(l) 

copy file archives in and out .cpio(l) 

copy fileto a new or existing file.cp(l) 

copy multiplefiles to a directory .cp(l) 

copy to or from DOS files.doscp(l) 

copy to or from remote system.rcp(l) 

copy to or from remote system.rcp(l) 

count words, lines, and bytes or characters in a file .wc(l) 

create a tags file .ctags(l) 

create the cat files for the manual.catman(lM) 

cut out (extract) selected fields of each line in a file.cut(l) 

determine file type.file(l) 

differential file comparator.diff(l) 

displayfileon CRT terminals.more(l) 

display fileon soft-copy terminals.pg(l) 

dump file in octal or hexadecimal format .od(l) 

eliminate adjacent repeated lines in a file.uniq(l) 

encrypt/decrypt files.crypt(l) 

error message file, extract error messages from C source into.mkstr(l) 

expand compressed file.compress(l) 

expand compressed files in a directory.compress(l) 

find (search for) files .find(l) 

find differences among three files.diff3(l) 

find differences between two files.diff(l) 

format tracing and logging binary files.netfmt(lM) 

get a version of an SCCS file .get(l) 

get first few lines in a file.head(l) 

get lines from last part of a file.tail(l) 

get SCCS identification information from files .what(l) 

get status.fstat(2) 

job file, prototype, for at .proto(4) 

list access control lists (ACLs) of files.Isacl(l) 

list access rights to file(s).getaccess(l) 

make a delta (change) to an SCCS file.delta(l) 

make unprintable and non-ASCI I characters in a file visible or invisible.vis(l) 

merge corresponding lines of several files or subsequent lines of one file .paste(l) 

name for a temporary file, make a.mktemp(l) 

network tracing and logging configuration file .nettlgen.conf(4) 

overwrite file with an existing file.cp(l) 

password file, edit using vi editor.vipw(lM) 

print and summarize an SCCS file.prs(l) 

print checksum and block count of a file.sum(l) 

print first few lines in a file .head(l) 

print section sizes and allocation space of object files.size(l) 

prototype job file for at .proto(4) 

queue description file for at, batch, and crontab .queuedefs(4) 
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files: read portable archive.pax(l) 

files: reduce multiple adjacent blank lines to single blank line.ssp(l) 

files: remove a delta from an SCCS file.rmdel(l) 

files: remove all blank lines from file .rmnl(l) 

files: remove DOS files or directories .dosrm(l) 

files: remove file that is not listed in any directory.clri(lM) 

files: remove .rm(l) 

files: report adjacent repeated lines in a file.uniq(l) 

files: reverse the Ieft-to-right text character sequence in each line of a file.rev(l) 

files: scheduleuucp transport files.uusched(lM) 

files: select/reject lines common to two sorted files.comm(l) 

files: selectively recover files from backup media.frecover(lM) 

files: sort and/or merge files .sort(l) 

files: split a file into multiple n-line pieces.split(l) 

files: split file into multiplefiles.csplit(l) 

files: strip symbol and line number information from an object file.strip(l) 

files: temporary file, make a name for a.mktemp(l) 

files: three-way differential file comparator .diff3(l) 

files: three-way file merge.merge(l) 

files: transfer uucp-system files in or out .uucico(lM) 

files: undo a previous get of an SCCS file .unget(l) 

files: user crontab file operations .crontab(l) 

files: verify internal revision numbers of HP-UX files.revck(lM) 

files: write portable archive .pax(l) 

filter .glossary(9) 

filter reverse line-feeds and backspaces from text .col(l) 

filter () - disableuseof certain terminal capabilities.filter(3X) 

filter, line numbering .nl(l) 

find adjacent repeated lines in a file.uniq(l) 

find differences among three files.diff3(l) 

find differences between two files.diff(l) 

find - find (search for) files .find(l) 

find hyphenated words.hyphen(l) 

find location of source, binary, and/or manual files for program.whereis(l) 

find manual information by keywords; print out a manual entry .man(l) 

find name of a terminal .ttyname(3C) 

find ordering relation for files in an object code library.lorder(l) 

find program files that execute under given command name.which(l) 

find spelling errors.spell(l) 

find strings for inclusion in message catalogs .findstr(l) 

find the printable strings in an object or other binary file.strings(l) 

find theslot in theutmpO file of the current user .ttyslot(3C) 

findmsg - create message catalog file for modification .findmsg(l) 

findstr(l) output, use to insert calls to catgets(3C) .insertmsg(l) 

findstr - find strings for inclusion in message catalogs .findstr(l) 

finger, change information in password file .chfn(l) 

finger - user information lookup program .finger(l) 

fingerd - remote user information server.fingerd(lM) 

finish using an ELF object file.elf_end(3E) 

finish, wait for background processes to .wait(l) 

finite-width output device, fold long lines for .fold(l) 

finiteness macro, floating-point.isfinite(3M) 

firmware (processor-dependent code).pdc(lM) 

first locations beyond allocated program regions .end(3C) 

firstkey () - get first key in database(old single-data-base version).dbm(3X) 

firstof2 (), FiRSTof2 () - test for valid first byte in 16-bit character.nl_tools_16(3X) 

fix damaged file system (generic).fsdb(lM) 

fix damaged HFS filesystem.fsdb_hfs(lM) 

fixman - fix manual pages for faster viewing with man(l).fixman(lM) 

flag for calling process, get audit process.getaudproc(2) 

flags, set, query configuration and loadableflagsfor a module.kmsystem(lM) 
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flash the screen .flash(3X) 

flash () - flash the screen .flash(3X) 

flexibleor "floppy" disk device driver.floppy(7) 

floating-point classification macros .fpclassify(3M) 

floating-point classification macros .isfinite(3M) 

floating-point classification macros.isinf(3M) 

floating-point classification macros.isnan(3M) 

floating-point classification macros .isnormal(3M) 

floating-point comparison macro (<) .isless(3M) 

floating-point comparison macro (<=).islessequal(3M) 

floating-point comparison macro (o).isiessgreater(3M) 

floating-point comparison macro (>) .isgreater(3M) 

floating-point comparison macro (>=) .isgreaterequal(3M) 

floating-point comparison macro (unordered).isunordered(3M) 

floating-point environment macros and functions .fenv(5) 

floating-point environment: getting.fegetenv(3M) 

floating-point environment: saving .feholdexcept(3M) 

floating-point environment: setting .fesetenv(3M) 

floating-point environment: updating .feupdateenv(3M) 

floating-point exception flags: getting .fegetexceptflag(3M) 

floating-point exception flags: setting .fesetexceptflag(3M) 

floating-point exceptions: clearing.feclearexcept(3M) 

floating-point exceptions: getting trap enable bits.fegettrapenable(3M) 

floating-point exceptions: raising .feraiseexcept(3M) 

floating-point exceptions: setting trap enable bits.fesettrapenable(3M) 

floating-point exceptions: testing.fetestexcept(3M) 

floating-point number to string, convert long double.ldcvt(3C) 

floating-point number, load exponent of a .ldexp(3M) 

floating-point number: decompose.modf(3M) 

floating-point rounding mode: getting.fegetround(3M) 

floating-point rounding mode: setting .fesetround(3M) 

floating-point sign-determination macro .signbit(3M) 

floating-point underflow mode: getting .fegetflushtozero(3M) 

floating-point underflow mode: setting .fesetflushtozero(3M) 

floating-point: convert floating-point number to string or string array element .ecvt(3C) 

floating-point: extract mantissa and exponent from double-precision number.frexp(3M) 

floating-point: load exponent of a radix-independent floating-point number .scalb(3M) 

floating-point: load exponent of a radix-independent floating-point number .seal bn (3M) 

fiockfile (), funfiockfile () - explicit locking of streams within a multi-thread application .... flockfile(3S) 

floor function .floor (3M) 

floor () - floor function .floor(3M) 

floppy - flexibleor "floppy" disk device driver.floppy(7) 

flush buffer with or without closing stream.fclose(3S) 

flush buffers to disk.sync(2) 

flush unwritten system buffers to disk .sync(lM) 

flush, enableor disableon interrupt .intrflush(3X) 

flushing queue, enabl^disable .noqiflush(3X) 

flushinp () - discard input.flushinp(3X) 

fmax () - maximum value function.fmax(3M) 

fmin() - minimum valuefunction.fmin(3M) 

fmod() - remainder functions.fmod(3M) 

fmodf () - remainder functions.fmod(3M) 

fmt - format text .fmt(l) 

fmtmsgo - displays formatted message on standard error and console.fmtmsg(3C) 

fnmatch () - match filename patterns .fnmatch(3C) 

fold - fold long lines for finite-width output device.fold(l) 

fontdi - download fonts to printer.Ipfilter(l) 

fopen() - open a named fileand associate with a stream.fopen(3S) 

fopen64 () - file system API to support large files .fgetpos64(2) 

for - execute a do list.ksh(l) 

for - execute a do list.sh-posix(l) 
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force process to relinquish processor .rtsched(2) 

force propagation of a Network Information Service database.yppush(lM) 

force target process to run serially with other processes.serialized) 

foreach - initiaterepetitive loop.csh(l) 

foreground process group .glossary(9) 

foreground process group ID .glossary(9) 

foreground process group ID, get.tcgetpgrp(3C) 

foreground process group ID, set .tcsetpgrp(3C) 

fork .glossary(9) 

fork handler .pthread_atfork(3T) 

fork () - create a new process.fork(2) 

format and print arguments .printf(l) 

format and print files.pr(l) 

format and semantics, locaiedef-command input script .localedef(4) 

format date and time, convert user.getdate(3C) 

format - format an HP SCSI disk array LUN .format(lM) 

format of a CDFS cdnode.cdnode(4) 

format of an inode.inode(4) 

format of directory streams and directory entries .dirent(5) 

format of HP-UX directory streams.ndir(5) 

format of VxFS file system volume.fs_vxfs(4) 

format of VxFS inode.inode_vxfs(4) 

format specification in text files .fspec(4) 

format text.fmt(l) 

format tracing and logging binary files.netfmt(lM) 

format, ioconfig entry .ioconfig(4) 

format, production specification file.swpackage(4) 

format, PSF .swpackage(4) 

format, tar tape archive .tar(4) 

format, translate host table file to name server .hosts_to_named(lM) 

format: common archive file.ar(4) 

format: convert DOS file to HP-UX ASCII file format .dos2ux(l) 

format: convert HP-UX ASCI I file to DOS file format .dos2ux(l) 

format: core image file.core(4) 

format: cpio archive.cpio(4) 

format: directories .dir(4) 

format: file system volume.fs(4) 

format: format mathematical text for nroff.neqn(l) 

format: format text filefor CRT or line-printer output .nroff(l) 

format: per-process accounting files .acct(4) 

format: privileged values .privgrp(4) 

format: Product Description Fileformat .pdf(4) 

format: symbol table structure.nlist(4) 

format: user accounting files btmp (), utmp (), and wtmp () .utmp(4) 

format: uuencode(l)-encoded file .uuencode(4) 

formatted input conversion to a varargs argument .vscanf(3S) 

formatted input conversion, read from stream file or character string .scanf(3S) 

formatted input, convert from a window.vwscanw(3X) 

formatted input, convert from a window .vw_scanw(3X) 

formatted input, convert, from a window.mvscanw(3X) 

formatted message catalog file, generate a .gencat(l) 

formatted message, displays on standard error and console.fmtmsg(3C) 

formatted output of a varargs argument list, print .vprintf(3S) 

formatted output, print in a window.vwprintw(3X) 

formatted output, print in a window .vw_printw(3X) 

formatted output, print in window .mvprintw(3X) 

formatted output, print to standard output, file, or string .printf(3S) 

formatted read and conversion from stream file or character string.scanf(3S) 

formatters, text .adjust(l) 

formatters: check or print documents formatted with the mm macros.mm(l) 

formatters: format text filefor CRT or line-printer output .nroff(l) 
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formatting conventions, numeric, of current locale, query.localeconv(3C) 

formatting documents, MM macro package for .mm(5) 

formatting manpages, macro package for .man (5) 

formatting routines, define label for .setlabel(3) 

FORTRAN execution startup routines .crt0(3) 

fpathconf () - get configurable path name variables.pathconf(2) 

fpciassify () - floating-point classification macro .fpclassify(3M) 

fprintf () - print formatted output to a file.printf(3S) 

fputc (), putc () - put character on a stream.putc(3S) 

fputs() - write null-terminated string to a named stream file.puts(3S) 

fputwc (), putwc () - put wide character on a stream .putwc(3C) 

fputws o - write null-terminated wide string to a named stream file .putws(3C) 

frame-buffer raster display device access .framebuf(7) 

framebuf - information for raster frame-buffer devices.framebuf(7) 

fread(), fwrite () - buffered binary input/output to a stream file.fread(3S) 

frecover - selectively recover files from backup media.frecover(lM) 

free a per-process timer .rmtimer(3C) 

free disk blocks on a VxFS filesystem .df_vxfs(lM) 

free disk blocks, report number of (Berkeley version) .bdf(lM) 

free DOS disk clusters, report number of .dosdf(l) 

free memory associated with word expansions .wordexp(3C) 

free memory for library structure (X/OPEN TLI-XTI) .t_free(3) 

free space percentage, dump file system .dumpfs(lM) 

free () - releaseallocated block of main memory .malloc(3C) 

freedisk - recover disk space.freedisk(lM) 

freenetconfigent () - get network configuration data base entry.getnetconfig(3N) 

freopen() - substitutea named filein place of an already open stream.fopen(3S) 

f reopen64 () - file system API to support large files .fgetpos64(2) 

frexp () - extract mantissa and exponent from double-precision number .frexp(3M) 

from - who is my mail from? .from(l) 

from, who is mail from.mailfrom(l) 

frto.o, mfrto.o - FORTRAN execution startup routines .crt0(3) 

f s - format of file system vol ume.fs(4) 

fsadm - filesystem administration command .fsadm(lM) 

f sadm hf s - H FS file system administration command.fsadm_hfs(lM) 

fsadm vxfs - resize or reorganizea VxFS filesystem .fsadm_vxfs(lM) 

fscanf () - formatted read from named input stream file.scanf(3S) 

fscat - cat a VxFS filesystem.fscat_vxfs(lM) 

fscat vxfs - cat a VxFS filesystem.fscat_vxfs(lM) 

fsck(lM), make a lost+found directory for .mklost-tfound(lM) 

fsck - check and repair VxFS file system .fsck_vxfs(lM) 

fsck - filesystem consistency check and interactive repair .fsck(lM) 

fsck - filesystem consistency check and interactive repair (generic).fsck(lM) 

fsck_vxfs - check and repair VxFS filesystem .fsck_vxfs(lM) 

fsclean - determine shutdown status of specified filesystem.fsclean(lM) 

fsctio - filesystem control.fsctl(2) 

fsdb - filesystem debugger (generic) .fsdb(lM) 

fsdb - H FS filesystem debugger .fsdb_hfs(lM) 

fsdb - VxFS filesystem debugger.fsdb_vxfs(lM) 

fsdb vxfs - VxFS filesystem debugger.fsdb_vxfs(lM) 

fseek (), rewind (), fteii () - reposition a file pointer in a stream .fseek(3S) 

fseek () - set position of next I/O operation on stream file.fseek(3S) 

fseeko () - set position of next I/O operation on stream file, non-POSIX API .fseek(3S) 

f seeko64 () - file system API to support large files .fgetpos64(2) 

fseek uniocked () - set position of next I/O operation on stream file, 

no locking of stream for multi-thread applications.fseek(3S) 

fsetaci () - set access control list (ACL) information .setacl(2) 

fsetacientry () - add, modify, or delete access control list entry.setaclentry(3C) 

fsetpos () - restore file position indicator for a stream.fgetpos(3S) 

fsetpos64() - filesystem API to support large files .fgetpos64(2) 

fsirand: install random inode generation numbers .fsirand(lM) 
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fspec - format specification in text files .fspec(4) 

f stab - static information about the file systems .fstab(4) 

fstat/stat/istat system call, data returned by .stat(5) 

fstat () - get file status.fstat(2) 

f stat64 () - file system API to support large files.creat64(2) 

fstatfs (), statfs () - get file system statistics .statfs(2) 

fstatfsdev(), statfsdev() - get filesystem statistics.statfsdev(3C) 

fstatvfs (), (statvf s ()) - get open file status.statvfs(2) 

f statvf sdev (), statvf sdev () - get file system statistics.statvfsdev(3C) 

f statvf sdev64 () - file system API to support large files .fgetpos64(2) 

fstyp - determine file system type.fstyp(lM) 

fsync (), fdatasync () - synchronize a file's i n-core state with its state on disk.fsync(2) 

f s_vxf s - format of VxFS file system vol ume.fs_vxfs(4) 

fs_wrapper - configuration and binary files used by filesystem administration commands.fs_wrapper(5) 

fteii () - get offset from beginning-of-file of current byte in stream file.fseek(3S) 

fteiio () - get offset from beginning-of-file of current byte in stream file, non-POSIX API .fseek(3S) 

fteiio64() - filesystem API to support large files .fgetpos64(2) 

fteii uniocked () - get offset from beginning-of-file of current byte in stream file, 

no locking of stream for multi-thread applications.fseek(3S) 

ftime () - get date and time more precisely (Version 7 compatibility only) .ftime(2) 

ftio - faster tape I/O .ftio(l) 

ftok () - create interprocess communication identifier .ftok(3C) 

ftp, login information for.netrc(4) 

ftp - file transfer program.ftp(l) 

ftpd, security filefor .ftpusers(4) 

ftpd - filetransfer protocol server .ftpd(lM) 

ftpusers - security filefor ftpd(lM).ftpusers(4) 

ftruncate () - truncatea fileto a specified length.truncate(2) 

ftw() - walk a file tree executing a function .ftw(3C) 

ftw64() - file sysmmaptem API to support large files.fgetpos64(2) 

full name: in elm aliases.newalias(l) 

function key codes, get from a terminal .getn_wstr(3X) 

function keys, enabl^disable abbreviation of.keypad(3X) 

function number .glossary(9) 

function to be called at program termination, register a.atexit(2) 

function, enhanced pad management .subpad(3X) 

function, execute descending a directory tree .ftw(3C) 

function, relative window creation .derwin(3X) 

function, window refresh control .touchwin(3X) 

functions and constants, math.math(5) 

functionsfor screen file input/output .scr_dump(3X) 

functionsof HP 2640-and HP 2621-series terminals, handlespecial.hp(l) 

functions, access NIS+database.nis_db(3N) 

functions, allowsignalsto interrupt.siginterrupt(2) 

functions, floating-point environment macros and .fenv(5) 

functions, for input mode control .cbreak(3X) 

functions, for lineupdatestatus .redrawwin(3X) 

functions, for pad management.newpad(3X) 

functions, miscNIS+.nis_servers(3N) 

functions, NIS+group manipulation functions .nis_groups(3N) 

functions, NIS+namespace.nis_names(3N) 

functions, NlS+tables .nis_tables(3N) 

functions, query, for terminal insert and delay capability.has_ic(3X) 

functions, screen initialisation functions.initscr(3X) 

functions, soft label.slk_attroff(3X) 

functions, window creation functions .newwin(3X) 

functions, window cursor location.move(3X) 

functions, window refresh control .is_linetouched(3X) 

funfiockfile (), fiockfiie() - explicit locking of streams within a multi-thread application .... flockfile(3S) 

fuser - list processes usinga fileor filestructure.fuser(lM) 

fwrite (), fread() - buffered binary input/output to a stream file.fread(3S) 
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fwtmp - manipulate connect accounting records . 

gamma function, log. 

gamma (), lgamma (), lgamma r (), signgam() - log gamma function 

gated configuration file syntax . 

gated configuration guide. 

gated - gateway routi ng daemon . 

gated's operational user interface . 

gated-config - gated configuration file syntax . 

gated.conf - GateD configuration guide . 

gateway routi ng daemon . 

gateways, monitor OSPF . 

gateways, query RIP . 

gcrto. o, gfrto. o - C and Pascal execution startup routines . 

gcvt () - convert floating-point number to string array element . 

gcvt () - convert floating-point number to string array element . 

gdc - operational user interface for gated . 

gencat - generate a formatted message catalog file . 

general terminal interface. 

general terminal interface, extended . 

generate a DES encryption key . 

generate a formatted message catalog file . 

generate a localeenvironment . 

generate an IOT fault . 

generate C header files . 

generate file name of controlling terminal . 

generate file names. 

generate hashing encryption . 

generate hashing encryption on large strings. 

generate iconv translation tables. 

generate large primes, factor a number . 

generate path names from i-numbers. 

generate pathnames from inode numbers for VxFS filesystem. 

generate permuted i ndex . 

generate printablerepresentation of a character . 

generate printablerepresentation of a wide character . 

generate RPC protocols, C header files . 

generate uniformly distributed pseudo-random numbers . 

generator, simple random-number. 

generic file system debugger . 

generic file system quota consistency checker . 

generic file system, construct . 

generic file system, mount or unmount. 

generic I/O device control commands . 

generic new file system, construct . 

genxit - generate iconv translation tables. 

geocustoms - configure system language on multi-language systems .. 

get a multi-byte character length limited stringfrom theterminal . 

get a multi-byte character stringfrom theterminal . 

get a single-bytecharacter from theterminal. 

get a user's effective access rights to a file . 

get a wide character from a terminal. 

get a wide character string and rendition from a cchar_t . 

get access control list (ACL) information. 

get additional cursor and window coordinates. 

get address of connected peer . 

get address of symbol in shared object . 

get an array of wide characters and function key codes from a terminal 

get an identifier for the current host. 

get and set concurrency level of unbound threads. 

get and set current user context . 

get and set the prioceiling attribute . 


Entry Name(Section) 

.fwtmp(lM) 

.lgamma(3M) 

.lgamma(3M) 

.gated, conf (4) 

.gated.conf (4) 

.gated(lM) 

.gdc(lM) 

.see gated.conf(4) 

.gated.conf (4) 

.gated (1M) 

.ospfmonitor(lM) 

.ripquery(lM) 

. crt0(3) 

.ecvt(3C) 

.ecvt(3C) 

.gdc(lM) 

.gencat(l) 

.ter mi o(7) 

.termiox(7) 

.makekey(l) 

.gencat(l) 

.localedef(lM) 

.abort(3C) 

.rpcgen(l) 

.ctermid(3S) 

.glob(3C) 

.crypt(3C) 

.bigcrypt(3C) 

.genxlt(l) 

. factor(1) 

.ncheck(lM) 

.ncheck_vxfs(lM) 

.ptx(l) 

.unctrl(3X) 

.wunctrl(3X) 

.rpcgen(l) 

.drand48(3C) 

.rand(3C) 

.fsdb(lM) 

.quotacheck(lM) 

.mkfs(lM) 

.mount(lM) 

.ioctl(5) 

.newfs(lM) 

.genxlt(l) 

.geocustoms(lM) 

.getnstr(3X) 

.getstr(3X) 

.getch(3X) 

.getaccess(2) 

.get_wch(3X) 

.getcchar(3X) 

.getacl(2) 

.getbegyx(3X) 

.getpeername(2) 

.dlsym(3C) 

.getn_wstr(3X) 

.gethostid(2) 

.pthread_getconcurrency(3T) 

.getcontext(2) 

pthread_mutexattr_getprotocol(3T) 
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get and set the prioceiling of a mutex .pthread_mutex_getprioceiling(3T) 

get and set the protocol attribute .pthread_mutexattr_getprotocol(3T) 

get and set the scheduling policy and associated parameters .pthread_getschedparam(3T) 

get and set the spin attribute.pthread_mutexattr_getspin_np(3T) 

get and set the thread-specific data associated with a key.pthread_getspecific(3T) 

get and set the yield frequency attribute.pthread_mutexattr_getspin_np(3T) 

get and/or set signal stack context .sigstack(2) 

get attributes for pthread .pthread_attr_getdetachstate(3T) 

get audit ID (aid()) for current process.getaudid(2) 

get audit process flag for calling process.getaudproc(2) 

get configurable path name variables.pathconf(2) 

get configurablesystem variables.sysconf(2) 

get current value of system-wide clock.getclock(3C) 

get cursor and window coordinates.getyx(3X) 

get disk description by its name.getdiskbyname(3C) 

get entries from a directory in a file-system-independent format.getdirentries(2) 

get events and system calls currently being audited.getevent(2) 

get extent attributes (VxFS).getext(lM) 

get file handle for file on remote node .getfh(2) 

get file handle for file on remote node, get .getfh(2) 

get file status .fstat(2) 

get file status.statvfs(2) 

get file system description file.getmntent(3X) 

get filesystem statistics .statfs(2) 

get file system statistics.statfsdev(3C) 

get file system statistics.statvfsdev(3C) 

get file system type info.sysfs(2) 

get first few lines in a file .head(l) 

get foreground process group ID .tcgetpgrp(3C) 

get - get a version of an SCCS file .get(l) 

get information about computer system .uname(2) 

get information about resource utilization.getrusage(2) 

get information about shared library.shl_load(3X) 

get information for a dynamically loaded kernel module .modstat(2) 

get information for a global kernel symbol .getksym(2) 

get legal user shells.getusershell(3C) 

get lines from last part of a file .tail(l) 

get locale-specific (NLS) information .locale(l) 

get login name.logname(l) 

get mounted file system statistics.ustat(2) 

get name of current NIS domain .getdomainname(2) 

get name of key .keyname(3X) 

get name of the user's terminal or pseudo-terminal .tty(l) 

get name of user logged in on this terminal .getlogin(3C) 

get network entry.getnetent(3N) 

get network group entry .getnetgrent(3C) 

get network host entry .gethostent(3N) 

get network status.netstat(l) 

get of an SCCS file, undo a previous .unget(l) 

get or set audit files .audctl(2) 

get or set background character and rendition using a complex character.bkgrnd(3X) 

get or set background character and rendition using a single-byte character.bkgd(3X) 

get or set the process-shared attribute.pthread_mutexattr_getpshared(3T) 

get or set the process-shared attribute .pthread_rwlockattr_getpshared(3T) 

get or set the thread process-shared attribute.pthread_condattr_getpshared(3T) 

get or set the type attribute.pthread_mutexattr_getpshared(3T) 

get or set tty baud rate.cfspeed(3C) 

get PAM error message string .pam_strerror(3) 

get pathname of current working directory.getwd(3C) 

get process priority .getpriority(2) 

get process, process group, or parent process ID .getpid(2) 
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get protocol entry .getprotoent(3N) 

get RPC entry.getrpcent(3C) 

get RPC port number .getrpcport(3N) 

get section information for ELF files .elf_getscn(3E) 

get service entry .getservent(3N) 

get signal alternate stack context .sigaltstack(2) 

get socket address .getsockname(2) 

get special attributesfor group.getprivgrp(2) 

get status information and attributes associated with a message queue.mq_getattr(2) 

get supported terminal video attributes.termattrs(3X) 

get system clock dateand time.gettimeofday(2) 

get system resource consumption limit.getrlimit(2) 

get terminal baud rate.baudrate(3X) 

get terminal name.termname(3X) 

get Terminal Session Manager state information .tsm.info(l) 

get t h e ba se offset foranobjectfile .el f_getbase(3E) 

get the current page size.getpagesize(2) 

get the locale of a program.setlocale(3C) 

get the name of a slave pty.ptsname(3C) 

get tty device operating parameters .tcattribute(3C) 

get valueof a per-process timer.gettimer(3C) 

get verbose description of current terminal.longname(3X) 

get X.25 line.getx25(lM) 

get, character or data word from a stream file.getc(3S) 

get, file status.stat(2) 

get, NLS program message.catgets(3C) 

get, or put bootptab entry - .getbootpent(3X) 

get, pointer for I/O operations on a stream file, get or reposition .fseek(3S) 

get, symbolic link status.Istat(2) 

get: data pointer for binary search tree .tsearch(3C) 

get: dateand time more precisely (Version 7 compatibility only) .ftime(2) 

get: entries from namelist .nlist(3C) 

get: entry from group () file.getgrent(3C) 

get: filesizelimitsand break value, get or set .ulimit(2) 

get: filesystem descriptor fileentry (BSD 4.2 compatibility only) .getfsent(3X) 

get: message queue.msgget(2) 

get: name of current host.gethostname(2) 

get: option letter from argument vector.getopt(3C) 

get: path-name of current working directory.getcwd(3C) 

get: process and child process times.times(2) 

get: real or effective user or group ID .getuid(2) 

get: set of semaphores .semget(2) 

get: shared memory segment.shmget(2) 

get: time .time(2) 

get: valueof process interval timer .getitimer(2) 

get: wide character from a stream file.getwc(3C) 

getaccess -1 ist access rights to file(s).getaccess(l) 

getaccess () - get a user's effective access rights to a file.getaccess(2) 

getaci (), fgetaci () - get access control list (ACL) information.getacl(2) 

getaudid(2) - FIP-UX Auditing System described.audit(5) 

getaudid() - get audit ID (aid ()) for current process.getaudid(2) 

getaudproc () - get audit process flag for calling process .getaudproc(2) 

getbegyx () - get additional cursor and window coordinates.getbegyx(3X) 

getc () - get character or word from a stream file.getc(3S) 

getcchar () - get a wide character string and rendition from a cchar_t .getcchar(3X) 

getch() - get a single-bytecharacter from theterminal.getch(3X) 

getchar () - get character or word from standard input file.getc(3S) 

getcharunlocked() - get character or word from standard input file . getc(3S) 

getciock () - get current value of system-wide clock.getclock(3C) 

getconf - get POSIX configuration values.getconf(l) 

getcontext () - get and set current user context .getcontext(2) 
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getcwd () - get path-name of current working directory.getcwd(3C) 

getc_uniock () - get character or word from a stream file.getc(3S) 

getdate () - convert user format date and time .getdate(3C) 

getdate_r () - convert user format date and time .getdate(3C) 

getdirentries () - get entries from a directory in a file-system-independent format.getdirentries(2) 

getdiskbyname () - get disk description by its name.getdiskbyname(3C) 

getdomainname () - get name of current NIS domain .getdomainname(2) 

getdvagent () - return pointer for device assignment databaseentry .getdvagent(3) 

getdvagnam() - return success or failure information .getdvagent(3) 

getegid() - get effective group ID .getuid(2) 

getenv() - return valuefor environment name.getenv(3C) 

geteuid() - get effective user ID .getuid(2) 

getevent(2) - HP-UX Auditing System described .audit(5) 

getevent () - get events and system calls currently being audited .getevent(2) 

getexportent () - access exported file system information .exportent(3N) 

getexportopt () - access exported file system information .exportent(3N) 

getext - get extent attributes (VxFS).getext(lM) 

getfh () - get file handle for file on remote node.getfh(2) 

getfsent () - get next line in file system descriptor file.getfsent(3X) 

getf sfile () - search descri ptor file for ordi nary file entry.getfsent(3X) 

getfsspec () - search descriptor filefor special (device) fileentry.getfsent(3X) 

getf stype () - search descri ptor file for specified file type entry .getfsent(3X) 

getgid() - get real group ID .getuid(2) 

getgrent () - get next entry in group () file.getgrent(3C) 

getgrgid () - get entry from group () file that matches gid() .getgrent(3C) 

getgrnam () - get entry from group () file that matches group name name () .getgrent(3C) 

getgroups () - get group access list.getgroups(2) 

gethostbyaddr () - get network host entry .gethostent(3N) 

gethostbyaddr r () - get network host entry (thread-safe).gethostent(3N) 

gethostbyname () - get network host entry .gethostent(3N) 

gethostbyname r () - get network host entry (thread-safe).gethostent(3N) 

gethostent () - get network host entry .gethostent(3N) 

gethostent_r () - get network host entry (thread-safe).gethostent(3N) 

gethostid() - get an identifier for thecurrent host.gethostid(2) 

gethostname () - get name of current host.gethostname(2) 

getitimer () - get valueof process interval timer .getitimer(2) 

getksym() - get information for a global kernel symbol.getksym(2) 

getiocale () - get the locale of a program.setlocale(3C) 

getiocaie_r () - get the locale of a program (MT-Safe).setlocale(3C) 

getiogin () - get name of user logged in on thisterminal .getlogin(3C) 

getiogin_r () - get name of user logged in and return name to buffer .getlogin(3C) 

getmaxyx () - get additional cursor and window coordinates.getbegyx(3X) 

getmntent () - get a filesystem description fileentry.getmntent(3X) 

getmsgt) - receive next message from a STREAMS file .getmsg(2) 

getnetbyaddr (): get network entry.getnetent(3N) 

getnetbyname (): get network entry.getnetent(3N) 

getnetconfig () - get network configuration data base entry.getnetconfig(3N) 

getnetconfigent () - get network configuration data base entry.getnetconfig(3N) 

getnetent (): get network entry.getnetent(3N) 

getnetgrent () - get network group entry .getnetgrent(3C) 

getnetname () - library routines for secure remote procedure calls.secure_rpc(3N) 

getnetpath() - get /etc/netconfig entry corresponding to NETPATH component .getnetpath(3N) 

getnstr () - get a multi-byte character length limited string from the terminal .getnstr(3X) 

getn__wstr () - get an array of wide characters and function key codes from a terminal.getn_wstr(3X) 

getopt - parse command options.getopt(l) 

getopto, optargO, optind(), opterr() - get option letter from argument vector.getopt(3C) 

getopts - parse utility (command) options .getopts(l) 

getpagesize () - get thecurrent page size.getpagesize(2) 

getparyx () - get additional cursor and window coordinates.getbegyx(3X) 

getpass () - read a password from terminal whilesuppressingecho .getpass(3C) 

getpeername () - get address of connected peer.getpeername(2) 
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getpgid () - get process group ID of specified process.getpid(2) 

getpgrp() - get process group ID .getpid(2) 

getpgrp2 () - get process group ID of specified process.getpid(2) 

getpid() - get process ID .getpid(2) 

getpmsg () - receive next message from a STREAMS file in a priority order.getmsg(2) 

getppid() - get parent process ID .getpid(2) 

getprdf ent () - manipulate system default databaseentry .getprdfent(3) 

getprdfnam () - manipulate system default databaseentry .getprdfent(3) 

getpriority () - get process priority .getpriority(2) 

getprivgrp - get special attributes for group.getprivgrp(l) 

getprivgrp () - get special attributes for group.getprivgrp(2) 

getprotobyname () - get protocol entry .getprotoent(3N) 

getprotobyname_r () - get protocol entry (thread-safe).getprotoent(3N) 

getprotobynumber () - get protocol entry .getprotoent(3N) 

getprotobynumber_r () - get protocol entry (thread-safe).getprotoent(3N) 

getprotoent () - get protocol entry .getprotoent(3N) 

getprotoent_r () - get protocol entry (thread-safe).getprotoent(3N) 

getprpwaid () - get protected password database audit ID .getprpwent(3) 

getprpwnam () - get protected password database user name .getprpwent(3) 

getprpwuid () - get protected password database user ID .getprpwent(3) 

getprtcent () - manipulate terminal control databaseentry .getprtcent(3) 

getprtcnam () - manipulate terminal control databaseentry .getprtcent(3) 

getpubiickey () - retrieve publicor secret key .getpublickey(3M) 

getpw () - get name from UID (obsolete).getpw(3C) 

getpwent () - get next password file entry .getpwent(3C) 

getpwnam () - get password file entry matching login name name () .getpwent(3C) 

getpwuid () - get password file entry matching uid () .getpwent(3C) 

getriimit () - get system resource consumption limit.getrlimit(2) 

getriimit64 () - file system API to support large files.creat64(2) 

getrpcbyname (): get RPC entry.getrpcent(3C) 

getrpcbynumber (): get RPC entry.getrpcent(3C) 

getrpcent (): get RPC entry.getrpcent(3C) 

getrpcport () - get RPC port number .getrpcport(3N) 

getrusage () - get information about resource utilization.getrusage(2) 

gets (), fgets () - get a string from a standard input stream .gets(3S) 

getsecretkey () - retrieve public or secret key .getpublickey(3M) 

getservbyname () - get service entry .getservent(3N) 

getservbyname r () - get service entry (thread-safe) .getservent(3N) 

getservbyport () - get service entry.getservent(3N) 

getservbyport_r () - get service entry (thread-safe) .getservent(3N) 

getservent () - get service entry .getservent(3N) 

getservent_r () - get service entry (thread-safe) .getservent(3N) 

getsid() - get session ID .getsid(2) 

getsockname () - get socket address.getsockname(2) 

getsockopt() - get options on sockets .getsockopt(2) 

getspent () - get next secure password file entry.getspent(3C) 

getspnam() - get secure password file entry matching name () .getspent(3C) 

getspwaid () - get next secure password file audit ID .getspwent(3X) 

getspwent () - get next secure password file entry.getspwent(3X) 

getspwnam () - get secure password file entry matching login namename() .getspwent(3X) 

getspwuid () - get secure password file entry matching uid () .getspwent(3X) 

getstr () - get a multi-byte character string from the terminal .getstr(3X) 

getsubopt () - parse suboptions from a string.getsubopt(3C) 

gettimeofday () - get system clock date and ti me.gettimeofday(2) 

gettimer() - get value of a per-process timer.gettimer(3C) 

gettxt (), create message files for use by .mkmsgs(l) 

gettxt () - read text string from message file.gettxt(3C) 

getty for 2-way lineaccessibleto uucp .uugetty(lM) 

getty - set terminal type, modes, speed, and linediscipline.getty (1M) 

getty to remote terminal, spawn (call terminal) .ct(l) 

gettydefs - speed and terminal settings used by getty.gettydefs(4) 
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getuid() - get real user ID .getuid(2) 

getusershell () - get legal user shells .getusershell(3C) 

getutent () - get pointer to next entry in a utmp () file.getut(3C) 

getutent_r () - get pointer to next entry in a utmp () file.getut(3C) 

getutid() - get poi nter to entry matching id () inautmpO file.getut(3C) 

getutid_r() - get poi nter to entry matching id () inautmpO file.getut(3C) 

getutiine () - get pointer to entry matching line () inautmpO file.getut(3C) 

getutiine_r () - get pointer to entry matching line () inautmpO file.getut(3C) 

getutxent () - get pointer to next entry in a utmpx () file.getutx(3C) 

getutxid () - get poi nter to entry matching id () inautmpx() file.getutx(3C) 

getutxiine () - get pointer to entry matching line () in a utmpx () file.getutx(3C) 

getw() - get data word (integer) from a stream file .getc(3S) 

getwc () - get wide character from a stream file.getwc(3C) 

getwchar () - get wide character from a stream file.getwc(3C) 

getwchar_uniocked () - get wide character from a stream file.getwc(3C) 

getwc unlocked () - get wide character from a stream file.getwc(3C) 

getwd () - get pathname of current working directory.getwd(3C) 

getwin() - dump window to and reload window from a file.getwin(3X) 

getw__uniocked() - get data word (integer) from a stream file .getc(3S) 

getx25 - get X.25 line.getx25(lM) 

getyx () - get cursor and window coordinates.getyx(3X) 

get expiration_time () - add a specific time interval to the current .get_expiration_time(3T) 

get myaddress () - obsolete library routines for RPC .rpc_soc(3N) 

get wch () - get a wide character from a terminal .get_wch(3X) 

get_wstr() - get an array of wide characters and function key codes from a terminal .getn_wstr(3X) 

gfrto.o, gcrto.o-C and Pascal execution startup routines .crt0(3) 

glob - echo without \ \' escapes .csh(l) 

glob () - file name generation function.glob(3C) 

global kernel symbol, get information for.getksym(2) 

global search path for dynamically loadable kernel modules, change .modpath(2) 

giobfree () - free space associated with file name generation function.glob(3C) 

glossary - a description of common HP-UXterms .glossary(9) 

gmtime (), gmtime_r () -convert date and ti me to Greenwich MeanTime.ctime(3C) 

goto - continue execution on specified line.csh(l) 

goto, save/restore stack environment for non-local .setjmp(3C) 

GPIO: return status lines of GP10 card .gpio_get_status(3l) 

GPIO: set control lines on GPIO card.gpio_set_ctl(3l) 

gpio_get_status () - return status li nes of GPIO card .gpio_get_status(3l) 

gpio_set_cti () - set control lines on GPIO card.gpio_set_ctl(3l) 

gprof - display call graph execution profile data .gprof(l) 

grant access to STREAMS slave pty.grantpt(3C) 

grantpt () - grant access to STREAMS slave pty.grantpt(3C) 

graph and display execution profile data.gprof(l) 

graphic character .glossary(9) 

grep - search a file for a pattern (compact algorithm).grep(l) 

grget - get group information.pwget(l) 

group access list .glossary(9) 

group access list: get group access list .getgroups(2) 

group access list: initializegroup access list .initgroups(3C) 

group access list: set group access list .setgroups(2) 

group and owner of a file, change .chown(2) 

group and password hashing and cashing daemon .pwgrd(lM) 

group and passwrod hashing and caching statistics .pwgr_stat(lM) 

group and/or owner, change in access control list (ACL).chownacl(3C) 

group availability(LVM), set volume.vgchange(lM) 

group configuration, restore volume.vgcfgrestore(lM) 

group entry, network, get or set.getnetgrent(3C) 

group file.login(l) 

group file, check .pwck(lM) 

group.glossary (9) 

group - group access and identification file, grp.h.group(4) 
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group ID for job control, set process .setpgid(2) 

group ID .glossary(9) 

group ID, create session and set process .setsid(2) 

group ID, foreground process, get .tcgetpgrp(3C) 

group ID, foreground process, set .tcsetpgrp(3C) 

group ID, set process group ID .setpgrp(2) 

group ID: get real or effective group ID .getuid(2) 

group ID: set group ID .setuid(2) 

group ID: set real, effective, and/or saved group or user IDs.setresuid(2) 

group IDs and names, print.id(l) 

group information, get (grget) .pwget(l) 

group manipulation functions, NIS+.nis_groups(3N) 

group memberships, show.groups(l) 

group of file, change .chown(l) 

group of processes, send signal.ki 11 (2) 

group owner: change for an NIS+ object .nischgrp(l) 

group () file, get entry from.getgrent(3C) 

group, add a new .groupadd(lM) 

group, associate with certain privileges.setprivgrp(lM) 

group, delete from the system.groupdel(lM) 

group, get or set special attributes .getprivgrp(2) 

group, get special attributes for.getprivgrp(l) 

group, log in to a new .newgrp(l) 

group, modify a.groupmod(lM) 

group-access privileged values, format of.privgrp(4) 

groupadd - add a new group to the system .groupadd(lM) 

groupdei - delete a group from the system.groupdel(lM) 

groupmod - modify a group on the system .groupmod(lM) 

groups of programs - maintain, update, and regenerate.make(l) 

groups - show group memberships.groups(l) 

groups, list of in network .netgroup(4) 

grpck - group file checker .pwck(lM) 

gsignai () - raise a software signal.ssignal(3C) 

gtty() - control terminal device (Bell Version 6 compatibility) .stty(2) 

halfdelay () - control input character delay mode .halfdelay(3X) 

HALGOL programs, execute .opx25(lM) 

halt or start auditing system.audctl(2) 

halt or start auditing system .audsys(lM) 

halt system operation .shutdown(lM) 

halt then reboot the system.reboot(lM) 

handle special functions of HP 2640- and HP 2621-series terminals.hp(l) 

hangups, run a command immune to.nohup(l) 

hard disk, fiexi ble disk, or cartridge tape media, initialize.mediainit(l) 

hardware insert- and delete-character features, enable or disable use of .idcok(3X) 

hardware machine model/series identification .model (4) 

hash codes, convert 9-digit to or from text for spell checking .spell(l) 

hash - remember command location in search path .sh-bourne(l) 

hash search tables, manage.hsearch(3C) 

hash value for ELF files, compute.elf_hash(3E) 

hashcheck - convert spelling reference list words to 9-digit hash codes for spell .spell(l) 

hashingand caching statistics, passwrod and group .pwgr_stat(lM) 

hashingand caching, password and group, daemon .pwgrd(lM) 

hashing encryption on large strings, generate.bigcrypt(3C) 

hashing encryption, generate.crypt(3C) 

hashmake - convert text words to 9-digit hash codes for spell .spell(l) 

hashstat - print hash table effectiveness statistics.csh(l) 

hasmntopt () - search mount option field in filesystem description file.getmntent(3X) 

has colors () - color manipulation functions.can_change_color(3X) 

has ic () - query functions for terminal insert and delay capability .has_ic(3X) 

has„ii() - query functions for terminal insert and delay capability .has_ic(3X) 

havedisk () - get performance data from remote kernel .rstat(3N) 
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hcreate () - allocate space for new hash search table.hsearch(3C) 

hdestroy () - destroy existing hash search table.hsearch(3C) 

head - get first few lines in a file .head(l) 

header file for future applications.portal(5) 

header file of macros for handling device numbers.mknod(5) 

header file organization, description of HP-UX.stdsyms(5) 

header files, C, generate .rpcgen(l) 

header, retrieve ELF class-dependent object file header .elf_getehdr(3E) 

help for SCCS commands .sccshelp(l) 

herror() - resolver routines.resolver(3N) 

hexadecimal equivalents: ASCII character set .ascii(5) 

hexadecimal file dump .od(l) 

HFS filesystem administration command .fsadm_hfs(lM) 

H F S file system debugger .fsdb_hfs(lM) 

HFS filesystem disk blocks, report number of free .df_hfs(lM) 

hfs file system quota consistency checker.quotachecknfs(lM) 

HFS filesystem, construct a new .newfs_hfs(lM) 

HFS filesystem, construct .mkfs_hfs(lM) 

HFS filesystem, copy with compaction .dcopy(lM) 

HFS filesystem, list file names and statistics.ff_hfs(lM) 

HFS filesystem: tune an existing file system.tunefs(lM) 

HFS filesystems, mount and unmount.mount_hfs(lM) 

hidden file .chmod(l) 

hidden file .chmod(2) 

hier - filesystem hierarchy .hier(5) 

hierarchical directory .glossary(9) 

hierarchy, directory, recursively descend a, executing a function.ftw(3C) 

hierarchy, file system .hier(5) 

high resolution sleep .nanosleep(2) 

hil - HP-HIL device driver.hil(7) 

hilkbd - HP-HIL cooked keyboard driver .hilkbd(7) 

history and input editor for interactive program commands .ied(l) 

history - Display event history list .csh(l) 

hiine () - draw li nes from single-byte characters and renditions .hline(3X) 

hiine set () - draw lines from complex characters and renditions.hline_set(3X) 

hold signal upon receipt .sighold(2V) 

hold signal upon receipt.sigset(3C) 

home directory .glossary(9) 

home environment variable.login(l) 

home machine is not available, login when VHE .vhe altlog(lM) 

host and network byte order, convert values between .byteorder(3N) 

host epu, set name of .sethostname(2) 

host entry, get, set, or end network .gethostent(3N) 

host is Network Information System server or map master, list which .ypwhich(l) 

host name.glossary(9) 

host name resolution description.hostname(5) 

host names database.hosts(4) 

host status of local machines (RPC version), show .rup(l) 

host system, set or display name of current .hostname(l) 

host table, translate to name server file format .hosts_to_named(lM) 

host test packets, send.ping(lM) 

host, current, get name of.gethostname(2) 

host, remote, execute command on a .on(l) 

host2netname () - library routines for secure remote procedure calls.secure_rpc(3N) 

hostname - host name resolution description.hostname(5) 

hostname - set or display name of current host system .hostname(l) 

hosts - hosts name database.hosts(4) 

hosts, compute shortest path and route between.pathalias(l) 

hosts, remote, authorizing access on local host .hosts.equiv(4) 

hosts. equiv file. login(l) 

hosts . equiv - security files authorizing access by remote hosts and users on local host .hosts.equiv(4) 
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hosts_to named - translate host table to name server file format. 

how to order HP-UX manuals . 

HP 2640- and HP 2621-series terminals, handle special functions of. 

HP 3000-mode packed decimal library. 

HP AdvanceLink and Basic Serial server. 

HP Character-Terminal User Environment (CUE). 

HP Distributed Printer System, advances a job to the top of a queue. 

HP Distributed Printer System, deletes print objects. 

HP Distributed Printer System, enables paused objects to resume operation . 

HP Distributed Printer System, modifies attributes of submitted print jobs. 

HP Distributed Printer System, modifies attributes of submitted print jobs . 

HP Distributed Printer System, pausesjobs, physical printers, servers, or queues. 

HP Distributed Printer System, queries and lists the status of one or more print jobs 

HP Distributed Printer System, removes print jobs. 

HP Distributed Printer System, resubmits previously submitted print jobs . 

HP Distributed Printer System, stop servers. 

HP Distributed Printer System, submits print jobs. 

hp - handle special functions of HP 2640- and HP 2621-series terminals. 

HP-HIL - cooked keyboard driver . 

HP-HIL: device driver. 

HP-IB I/O bus driver . 

HP-IB: allow interface to enable SRQ lineon HP-IB . 

HP-IB: change active controllers on HP-IB . 

HP-IB: conduct a serial poll on HP-IB . 

HP-IB: control EOI mode for HP-IB file . 

HP-IB: control response to parallel poll on HP-IB . 

HP-IB: control theRemote Enableline on HP-IB . 

HP-IB: perform I/O with an HP-IB channel from buffers. 

HP-IB: return status of H P-l B i nterface. 

HP-IB: send command bytes over HP-IB . 

HP-IB: stop activity on specified HP-IB . 

HP-IB: wait until a particular parallel poll valueoccurs . 

HP-IB: wait until the requested status condition becomes true. 

HP-UX Audio . 

HP-UX bootstrap and installation utility. 

HP-UX files, verify internal revision numbers of. 

HP-UX header file organization, description of. 

HP-UX implementations, magic numbers for . 

HP-UX kernel or kernel module, build a bootable. 

HP-UX machine identification . 

HP-UX manuals, list of orderable. 

HP-UX model, print name of current. 

HP-UX Reference manual, introduction . 

HP-UX system, configure and build. 

HP-UX terms, glossary of . 

HP-UX, introduction . 

hp 2686 a - laserjet filter. 

hp2934a - character printer filter. 

hp9000s200 - is processor an HP 9000 Series 200? . 

hp9000s300 - is processor an HP9000 Series 300? . 

hp9000s500 - is processor an HP 9000 Series 500? . 

hp9000s800 - is processor an HP9000 Series 800? . 

HPDPS gateway printers, configuration file. 

hpib - Hewlett-Packard I nterface Bus driver. 

hpib abort () - stop activity on specified HP-IB . 

hpib bus status () - return status of HP-IB interface. 

hpib_card_ppoii_resp () - control response to parallel poll on HP-IB . 

hpib eoi_cti () - control EOI mode for HP-IB file . 

hpib io() - perform I/O with an HP-IB channel from buffers. 

hpib_pass_cti () - change active controllers on HP-1 B . 

hpib_ren_cti () - control the Remote Enable line on HP-l B . 


.hosts_to_named(lM) 

.manuals(5) 

.hp(l) 

.hppac(3X) 

.pcserver(lM) 

.cue(l) 

.pdpromote(l) 

.pddelete(l) 

.pdresume(l) 

.pdmod(l) 

.pdset(l) 

.pdpause(l) 

.pdq(l) 

.pdrm(l) 

.pdresubmit(l) 

.pdshutdown(l) 

.pdpr(l) 

.hp(l) 

.hilkbd(7) 

.hi I (7) 

.hpib(7) 

.hpib_rqst_srvce(3l) 

.hpib_pass_ctl(3l) 

.hpib_spoll(3l) 

.hpib_eoi_ctl(3l) 

h pi b_card_ppol l_resp(3l) 

.hpib_ren_ctl(3l) 

.hpib_io(3l) 

.hpib_bus_status(3l) 

.hpib_send_cmnd(3l) 

.hpib_abort(3l) 

... hpib_wait_on_ppoll(3l) 

.hpib_status_wait(3l) 

.asecure(lM) 

.hpux(lM) 

.revck(lM) 

.stdsyms(5) 

.magic (4) 

.mk_kernel(lM) 

.model (4) 

.manuals(5) 

.model (1) 

.Introduction^) 

.config(lM) 

.glossary (9) 

.Introduction^) 

.Ipfilter(l) 

.Ipfilter(l) 

.machid(l) 

.machid(l) 

.machid(l) 

.machid(l) 

.pdgwcfg.conf(4) 

.hpib(7) 

.hpib_abort(3l) 

.hpib_bus_status(3l) 

hpib_card_ppoll_resp(3l) 

.hpib_eoi_ctl(3l) 

.hpib_io(3l) 

.hpib_pass_ctl(3l) 

.hpib_ren_ctl(3l) 
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Description Entry Name(Section) 

hpib_rqst_srvce () - al low interface to enable SRQ line on H P-l B .hpib_rqst_srvce(3l) 

hpib send cmnd () - send command bytes over HP-IB .hpib_send_cmnd(3l) 

hpib spoii() - conduct a serial poll on HP-IB .hpib_spoll(3l) 

hpib status wait () - wait until the requested status condition becomes true.hpib_status_wait(3l) 

hpib_wait_on_ppoii () - wait until a particular parallel poll valueoccurs .hpib_wait_on_ppoll(3l) 

HPPAC*: HP 3000-mode packed decimal library .hppac(3X) 

hpux - HP-UX bootstrap and installation utility.hpux(lM) 

hpux scheduling policy.rtsched(2) 

hsearch () - hash table search routine .hsearch(3C) 

htoni () - convert values between host and network byte order .byteorder(3N) 

htons () - convert values between host and network byte order .byteorder(3N) 

hyperbolic cosine function, inverse.acosh(3M) 

hyperbolic cosine functions .cosh(3M) 

hyperbolicsinefunction, inverse.asinh(3M) 

hyperbolic sine functions.sinh(3M) 

hyperbolic tangent function, inverse.atanh(3M) 

hyperbolic tangent functions.tanh(3M) 

hyphen - find hyphenated words.hyphen(l) 

hyphenated words, find.hyphen(l) 

hypot() - Euclidean distance function .hypot(3M) 

hypotenuse of a right triangle.hypot(3M) 

i-number, list path name corresponding to.ff_hfs(lM) 

i-numbers, generate path names from.ncheck(lM) 

I/O (NLIO) Subsystem, NativeLanguage.nlio(5) 

I/O card access information, network .Ian(7) 

I/O data path width (in bits), set .io_width_ctl(3l) 

I/O device control commands, generic .ioctl(5) 

I/O device drivers .(see special files) 

I/O device file, list a.Issf(lM) 

I/O device interrupt (fault) control .io_on_interrupt(3l) 

I/O device, who is currently using.fuser(lM) 

I/O interface, reset an.io_reset(3l) 

I/O interface, unlock or lock an .io_lock(3l) 

I/O interrupts for the associated eid(), disableor enable.io_interrupt_ctl(3l) 

I/O multiplexing, synchronous .select) 2) 

1 10 on kernel memory based on symbol name, perform .kmem(7) 

I/O operations on a stream file, get or reposition pointer for .fseek(3S) 

I/O operations, set time limit for.io_timeout_ctl(3l) 

I/O pipe to or from a process, open or close.popen(3S) 

I/O read termination character on special file, set up .io_eol_ctl(3l) 

I/O read, determine how last terminated .io_get_term_reason(3l) 

I/O redirection .glossary(9) 

I/O statistics, report .iostat(l) 

I/O subsystem, diagnostic interface to .diag0(7) 

I/O system, scan the.ioscan(lM) 

I/O to a stream file, buffered binary.fread(3S) 

I/O with an HP-IB channel from buffers, perform.hpib_io(3l) 

I/O, asynchronous synchronize.aio_fsync(2) 

I/O, asynchronous write.aio_write(2) 

I/O, asynchronous, error status .aio_error(2) 

I/O, asynchronous, POSIX .aio(5) 

I/O, asynchronous, start list of operations .lio_listio(2) 

I/O, cancel asynchronous.aio_cancel(2) 

I/O, control character device special file .ioctl(2) 

I/O, faster tape .ftio(l) 

I/O, POSIX asynchronous.aio(5) 

I/O, read asynchronous .aio_read(2) 

I/O, return asynchronous status.aio_return(2) 

I/O, suspend for asynchronous completion .aio_suspend(2) 

I/O, wait for asynchronous completion .aio_suspend(2) 

I/O: GPIO card, return statuslines of.gpi o_get_ statu s(3l) 
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Description Entry Name(Section) 

I/O: GPIO card, set control lines on .gpio_set_ctl(3l) 

i4admin - administer LicensePower/iFOR licensing.i4admin(lM) 

i4imd - starts the license server .i4lmd(lM) 

i4start - LicensePower/iFOR server start tool .i4start(lM) 

i4stop - LicensePower/iFOR server stop tool .i4stop(lM) 

i4target - print information about local LicensePower/iFOR target id.i4target(lM) 

i4tv - verify Network Li cense Servers are working.i4tv(lM) 

IBM 3179G/3192G, 3270, 3777terminal emulator.sna(l) 

iconv - character code set conversion .iconv(l) 

iconv translation tables to a readable format, dump.dmpxlt(l) 

iconv translation tables, generate.genxlt(l) 

iconv() - code set conversion routine, convert character .iconv(3C) 

iconv_ciose () - code set conversion routine, deal locate conversion descriptor.iconv(3C) 

iconv open () - code set conversion routine, return conversion descriptor .iconv(3C) 

ID for job control, set process group .setpgid(2) 

id - print user and group IDs and names .id(l) 

ID to file path, map device .devnm(3) 

ID, create session and set process group .setsid(2) 

ID, effective current user, print or display .whoami(l) 

ID, foreground process group, get.tcgetpgrp(3C) 

ID, foreground process group, set .tcsetpgrp(3C) 

ID, get real or effective user or group .getuid(2) 

ID, get session .getsid(2) 

ID, get terminal session.tcgetsid(3C) 

ID, obtain the thread ID for thecallingthread.pthread_self(3T) 

ID, set process group ID .setpgrp(2) 

ID, set user or group .setuid(2) 

idcok () - enableor disableuseof hardware insert- and delete-character features.idcok(3X) 

ident - identify files in Revision Control System.ident(l) 

I DENT protocol server, TCP/I P .identd(lM) 

identd - TCP/I P IDENT protocol server .identd(lM) 

identification file, /etc/issue .issue(4) 


identification information, SCCS, get from files. 

identifier, create interprocess communication. 

identifier, get for the current host. 

identifiers, compare two thread identifiers . 

identify files in Revision Control System . 

identify terminal type. 

identify the user of a particular TCP connection . 

idieok () - terminal output control functions . 

idiookup - identify the user of a particular TCP connection 

IDs, print user and group . 

IDs, processor, determined. 

IDs, set real and effective user IDs. 


.what(l) 

.ftok(3C) 

.gethostid(2) 

.pthread_equal(3T) 

.ident(l) 

.ttytype(l) 

.idlookup(l) 

.clearok(3X) 

.idlookup(l) 

.id(l) 

pthread_processor_bind_np(3T) 
.setreuid(2) 


led - input editor and command history for interactive programs . ied(l) 

IEEE-488 bus driver . hpib(7) 

if - execute command if expression evaluates true. csh(l) 

if - execute command if previous command returns exit status 0 . ksh(l) 

if - execute command if previous command returns exit status 0 . sh-posix(l) 

ifconfig - configure network interface parameters . ifconfig(lM) 

ignorable signals mask, set current. sigsetmask(2) 

ignore signal . sighold(2V) 

ignore signal. sigset(3C) 

ignore signals . sigblock(2) 

ilogb () - unbiased exponent function. ilogb(3M) 

image file, main memory and kernel memory . mem(7) 

image . glossary(9) 

immediate terminal refresh, enable/disable . immedok(3X) 


immedok () - enable or disable immediate terminal refresh 


immedok(3X) 


implementation-specific constants. Iimits(5) 

implementations, FIP-UX, magic numbers for . magic(4) 
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import an LVM volume group onto the system.vgimport(lM) 

in-core state with its state on disk, synchronize a file's.fsync(2) 

inbound zone transfer, ancillary agent .named-xfer(lM) 

inch() - input a single-byte character and rendition from a window.inch(3X) 

inchnstr() - i nput an array of single-byte characters and renditions from a wi ndow .inchnstr(3X) 

inchstr() - i nput an array of single-byte characters and renditions from a wi ndow .inchnstr(3X) 

include and conditional instructions, process C language.cpp(l) 

incoming mailbox file, print out mail in the.prmail(l) 

incoming messages from other users to terminal, deny or permit write(l).mesg(l) 

incomplete executable, prepare for faster program start-up.fastbind(l) 

increase data segment space allocation .brk(2) 

increasemirrorsfor LVM logical volume.Ivextend(lM) 

i ncrease space for LVM logical volume.Ivextend(lM) 

incremental filesystem dump (for backups).dump(lM) 

incrementally restore filesystem .restore(lM) 

index () - BSD portability string routine .string(3C) 

index, generate permuted .ptx(l) 

inet - Internet protocol family.inet(7F) 

inetd configuration file.inetd.conf(4) 

inetd -1 nternet services daemon .inetd(lM) 

inetd optional security file.inetd.sec(4) 

inetd. conf - configuration filefor inetd .inetd.conf(4) 

inetd. sec - optional inetd security file.inetd.sec(4) 

inetsvcs. confeonfiguration filefor secure internet services.inetsvcs.conf(4) 

inetsvcs sec - enableor disablesecure internet services.inetsvcs_sec(lM) 

inet addr () -1 nternet address manipulation routines .inet(3N) 

inet lnaof () -1 nternet address manipulation routines .inet(3N) 

inet makeaddr () -1 nternet address manipulation routines .inet(3N) 

inet netof () -1 nternet address manipulation routines .inet(3N) 

inet network () -1 nternet address manipulation routines .inet(3N) 

inet ntoa () -1 nternet address manipulation routines .inet(3N) 

inet_ntoa_r () -1 nternet address manipulation routines .inet(3N) 

infinity, test for.isinf(3M) 

info - disklessclient configuration information file .info(4) 

infocmp - compare or print out terminfo descriptions.infocmp(lM) 

information about an NIS map, query an NIS server for.yppoll(lM) 

information about LVM logical volumes, display .Ivdisplay(lM) 

information about physical volumes in LVM volume group, display.pvdisplay(lM) 

information about resource utilization, get.getrusage(2) 

information about top processes on system, display and update.top(l) 

information about users on remote machines, return.rnusers(3N) 

information file, disklessclient configuration .info(4) 

information file, driver, for insf, mksf, lssf.devices(4) 

information file, LVM physical volume group .Ivmpvg(4) 

information file, Virtual Home Environment .vhe_list(4) 

information for a dynamically loaded kernel module, get .modstat(2) 

information for a global kernel symbol, get.getksym(2) 

information for raster frame-buffer device access.framebuf(7) 

information in password file; used by finger, change.chfn(l) 

information name service: new version .nis-Kl) 

information on current terminal .cur_term(3X) 

information on loaded module (program or shared libary).dlget(3C) 

information on loaded module (program or shared libary).dlmodinfo(3C) 

information server, remote user.fingerd(lM) 

information, access exported filesystem.exportent(3N) 

information, audit, display as requested by parameters .audisp(lM) 

information, changes NIS.ypupdate(3C) 

information, current user, look up.finger(l) 

information, display software product .swlist(lM) 

information, get locale-specific (NLS).locale(l) 

information, get Terminal Session Manager state.tsm.info(l) 
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information, network I/O card access . 

information, NLS, about native languages. 

information, SCCS identification, get from files. 

information, system paging space . 

init . 

init - process control initialization . 

init process script . 

initgroups () - initialize group access list. 

initial system loader . 

initialisation functions for screen . 

initialization routine called only once, threads . 

initialization utility, NlS+dient and server . 

initializea NIS+domain . 

initializea thread attribute object. 

initializean unnamed semaphore. 

initializeand connect all system FDDI network interfaces . 

initializeand destroy a mutex . 

initializeFDDI interface. 

initialize group access list. 

initialize hard disk, flexi ble disk, or cartridge tape media. 

initial ize NIS+ credentials for NIS+ principals. 

initializeor destroy a mutex attribute object. 

initializeor destroy a read-write lock . 

initializeor destroy a read-write lock attribute object . 

initializeor destroy a thread condition variable . 

initializeor destroy a thread condition variableattributes object .. 
initialize semaphore in mapped file or anonymous memory region 

initializeterminal based on terminal type . 

initialize, manipulate, and test signal sets. 

initiateconnection on a socket. 

initscr () - screen initialisation functions. 


Entry Name(Section) 

.Ian (7) 

.nl_langinfo(3C) 

.what(l) 

.swapinfo(lM) 

.glossary (9) 

.init(lM) 

.inittab(4) 

.initgroups(3C) 

.isl(lM) 

.initscr(3X) 

.pthread_once(3T) 

.nisinit(lM) 

.nissetup(lM) 

.pthread_attr_init(3T) 

.sem_init(2) 

.fddisetup(lM) 

.pthread_mutex_init(3T) 

.fddiinit(lM) 

.initgroups(3C) 

.mediainit(l) 

.nisclient(lM) 

pthread_mutexattr_init(3T) 

.pthread_rwlock_init(3T) 

pthread_rwlockattr_init(3T) 

.pthread_cond_init(3T) 

... pthread_condattr_init(3T) 

.msem_init(2) 

.tset(l) 

.sigsetops(3C) 

.connect(2) 

.initscr(3X) 


initstate (), setstate (), random (), srandom() - generate a pseudorandom number .random(3M) 


inittab - script for the init process.inittab(4) 

init_color() - color manipulation functions.can_change_color(3X) 

init_pair() - color manipulation functions.can_change_color(3X) 

innetgr () - get network group entry .getnetgrent(3C) 

innstr () - input a multi-byte character string from a window .innstr(3X) 

innwstr () - input a string of wide characters from a window.innwstr(3X) 

inode - format of an inode.inode(4) 


inode generation numbers, install random .fsirand(lM) 

inode .glossary(9) 

inode number .glossary(9) 

inode numbers for VxFS filesystem, generate pathnames from .ncheck_vxfs(lM) 

inode, clear.clri(lM) 


inode vxfs - format of VxF S i node 


inode_vxfs(4) 


input a complex character and rendition from a window . 

input a multi-byte character stringfrom a window . 

input a single-bytecharacter and rendition from a window. 

input a string of wide characters from a window. 

input an array of complex characters and renditions from a window ... 
input an array of single-byte characters and renditions from a window 

input character, control delay mode . 

input conversion, formatted read from stream file or character string . 

input conversion, formatted, to a varargs argument . 

input editor and command history for interactive programs . 

input mode control functions . 

input queue, push a character onto. 

input script format and semantics, locaiedef-command . 

input singlelinefrom user keyboard . 

input stream, push character back into. 

input stream, push wide character back into . 


in_wch(3X) 
innstr(3X) 
... inch(3X) 

.innwstr(3X) 

in_wchnstr(3X) 
.... inchnstr(3X) 
... halfdelay(3X) 

.scanf(3S) 

.vscanf(3S) 

.ied(l) 

.cbreak(3X) 

.ungetch(3X) 

.localedef(4) 

line(l) 

.ungetc(3S) 

.... ungetwc(3C) 
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input string from a standard input stream.gets(3S) 

input wide string from a stream file.fgetws(3C) 

input, control blocking on .notimeout(3X) 

input, convert formatted, from a window.mvscanw(3X) 

input, discard.flushinp(3X) 

input, read a line from standard .read(l) 

input/output functions for screen file .scr_dump(3X) 

input/output to a stream file, buffered binary .fread(3S) 

input/output, buffered, standard stream file package.stdio(3S) 

insch() - insert a single-byte character and rendition intoa window.insch(3X) 

insdeiin () - delete or insert lines into a window .insdelln(3X) 

insert a complex character and rendition into a window .ins_wch(3X) 

insert a multi-byte character into a window .insnstr(3X) 

insert a single-byte character and rendition intoa window.insch(3X) 

insert a wide-character string into a window .ins_nwstr(3X) 

insert and delay capability, for terminal .has_ic(3X) 

insert calls to catgets(3C) based on findstr(l) output .insertmsg(l) 

insert lines into a window.insertln(3X) 

insert or delete lines into a window .insdelln(3X) 

insert or remove an element in a queue.insque(3C) 

insert- and delete-character features, hardware, enable or disable use of.idcok(3X) 

insertin () - insert lines into a window.insertln(3X) 

insertmsg - usefindstr(l) output to insert callsto catgets(3C) .insertmsg(l) 

insf - install special (device) files.insf(lM) 

insnstr () - insert a multi-byte character intoa window.insnstr(3X) 

insque () - insert an element in a queue .insque(3C) 

insstr () - insert a multi-byte character intoa window .insnstr(3X) 

install - install new commands .install(lM) 

install Network Information Service databases, build and .ypinit(lM) 

install new elm aliases for user or system .newalias(l) 

install object files in binary directories.cpset(lM) 

install random inode generation numbers .fsirand(lM) 

install Software Distributor agent on remote systems.pushAgent(lM) 

install special (device) files.insf(lM) 

install, monitor, create, distribute, and manage software.sd(5) 

install, software products.swinstall(lM) 

install, update, or remove boot programs from a disk device.mkboot(lM) 

installation and bootstrap utility, HP-UX.hpux(lM) 

installed software, configure, unconfigure, reconfigure .swconfig(lM) 

instr() - input a multi-byte character stringfrom a window .innstr(3X) 

ins nwstr () - insert a wide-character string into a window.ins_nwstr(3X) 

ins wch() - insert a complex character and rendition intoa window.ins_wch(3X) 

ins wstr () - insert a wide-character string into a window.ins_nwstr(3X) 

int, round to nearest functions.rint(3M) 

integer absolute value, return .abs(3C) 

integer data types.inttypes(5) 

integer division and remainder .div(3C) 

integer to base-64 ASCI I string, convert long.a64l(3C) 

integer, convert stringto long.strtol(3C) 

integer, convert wide character stringto long .wcstol(3C) 

integer, long, convert to string.ltostr(3C) 

integers, convert between 3-byteintegers and long integers .l3tol(3C) 

interactive mail message processing system.mailx(l) 

interactive programs, input editor and command history for .ied(l) 

interactively write (talk) to another user .write(l) 

interface for stape, tape2 and tapel, magnetic tape .mt(7) 

interface parameters, configure network .ifconfig(lM) 

interface status, show FDDI .fddistat(lM) 

interface status, show PCI FDDI .fddipciadmin(lM) 

interface to theTELNET protocol, user .telnet(l) 

interface, block mode terminal .blmode(7) 
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interface, Centronics-compatible.cent(7) 

interface, extended general terminal .termiox(7) 

interface, GPIO: return status lines of GP10 card.gpio_get_status(3l) 

interface, GPIO: set control lines on GPIO card .gpio_set_ctl(3l) 

interface, HP-IB: allow interface to enableSRQ line on HP-IB .hpib_rqst_srvce(3l) 

interface, HP-IB: change active controllers on HP-IB .hpib_pass_ctl(3l) 

interface, HP-IB: conduct a serial poll on HP-IB .hpib_spoll(3l) 

interface, HP-IB: control EOI mode for HP-IB file.hpib_eoi_ctl(3l) 

interface, HP-IB: control response to parallel poll on HP-IB .hpib_card_ppoll_resp(3l) 

interface, HP-IB: control theHP-IB interface Remote Enable line.hpib_ren_ctl(3l) 

interface, HP-1 B: HP-1 B I/O bus driver .hpib(7) 

interface, HP-IB: perform I/O with an HP-IB channel from buffers .hpib_io(3l) 

interface, HP-IB: return status of HP-1 B interface .hpib_bus_status(3l) 

interface, HP-IB: send command bytes over HP-IB .hpib_send_cmnd(3l) 

interface, HP-IB: stop activity on specified HP-IB .hpib_abort(3l) 

interface, HP-IB: wait until a particular parallel poll valueoccurs.hpib_wait_on_ppoll(3l) 

interface, HP-IB: wait until the requested status condition becomes true.hpib_status_wait(3l) 

interface, initializeFDDI .fddiinit(lM) 

interface, Network Information Service client .ypclnt(3C) 

interface, reset an I/O .io_reset(3l) 

interface, stop and reset FDDI .fddistop(lM) 

interface, terminal: general terminal interface.termio(7) 

interface, terminal: process-controlling terminal device file.tty(7) 

interface, terminal: system console interface special file.console(7) 

interface, terminal: Version 6/PWB-compatibileterminal interface.sttyv6(7) 

interface, unlock or lock an I/O .io_lock(3l) 

interfaces to terminfo database.del_curterm(3X) 

interfaces, initializeand connect all system FDDI network .fddisetup(lM) 

interleave factor .glossary(9) 

interleaved paging and swapping, add swap device for.swapon(2) 

internal attributes, change program's .chatr(l) 

internal consistency of Authentication database, check.authck(lM) 

internal revision numbers of HP-UX files, verify .revck(lM) 

Internal Terminal Emulator (ITE) .glossary(9) 

Internal Terminal Emulator (ITE), load keyboard mapping .itemap(lM) 

internationalization .glossary(9) 

I nternet address manipulation routines .inet(3N) 

Internet Boot Protocol server .bootpd(lM) 

Internet domain name server.named(lM) 

Internet protocol family.inet(7F) 

I nternet Protocol, IP .IP(7P) 

Internet services daemon .inetd(lM) 

Internet Transmission Control Protocol, TCP .TCP(7P) 

I nternet user datagram protocol .UDP(7P) 

Internet user name directory service.whois(l) 

Internet, send mail over the .sendmail(lM) 

interpret ASA carriage control characters.asa(l) 

interpreter, command (shell) with C-like syntax .csh(l) 

interpreter/compiler for modest-sized programs.bs(l) 

interprocess channel, create an .pipe(2) 

interprocess communication facilities, report status.ipcs(l) 

interprocess communication identifier, create.ftok(3C) 

Interprocess communications.socket(7) 

interrupt (fault) conditions, define for I/O device.io_on_interrupt(3l) 

interrupt functions, allowing signalsto.siginterrupt(2) 

interrupt signal .glossary(9) 

interrupt, atomically release blocked signalsand wait for .sigpause(2) 

interrupt, enable or disableflush.intrflush(3X) 

interrupts for the associated eid(), disable or enable I/O.io_interrupt_ctl(3l) 

interval timer, set or get valueof process .getitimer(2) 

interval timer, set .ualarm(2) 
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interval, suspend execution for a time.sleep(l) 

interval, suspend execution for an interval .usleep(2) 

interval, suspend execution for .sleep(3C) 

intrflush() - enableor disableflush on interrupt.intrflush(3X) 

intrinsic.glossary(9) 

introduction to access control lists.acl(5) 

introduction to command utilities and application programs .intro(l) 

introduction to device special files .intro(7) 

introduction to fileformats.intro(4) 

introduction to general information section .intro(9) 

introduction to HP-UX operating system and HP-UX Reference .Introduction^) 

introduction to miscellany.intro(5) 

introduction to POSlX.lc threads .pthread(3T) 

introduction to subroutines and libraries.intro(3) 

introduction to system calls.intro(2) 

introduction to system maintenance commands and application programs.intro(lM) 

inttypes - basic integer data types .inttypes(5) 

inv - make unprintableand non-ASCI I characters in a file invisible.vis(l) 

inverse hyperbolic cosine function.acosh(3M) 

inverse hyperbolic sine function .asinh(3M) 

inverse hyperbolic tangent function .atanh(3M) 

inwstr () - input a string of wide characters from a window.innwstr(3X) 

in wch () - input a complex character and rendition from a window .in_wch(3X) 

in wchnstr () - input an array of complex characters and renditions from a window.in_wchnstr(3X) 

in wchstr () - input an array of complex characters and renditions from a window.in_wchnstr(3X) 

ioconfig - ioconfig entry format .ioconfig(4) 

ioctl commands: STREAMS .streamio(7) 

iocti - generic I/O device control commands .ioctl(5) 

ioctl () - control character device special file .ioctl(2) 

ioctl: STREAMS modulefor converting.timod(7) 

ioinit - initializel/O system .ioinit(lM) 

ioinit - maintain consistency between data structures and /etc/ioconfig.ioinit(lM) 

iomap - physical memory address mapping.iomap(7) 

ioscan - scan the I/O system.ioscan(lM) 

iostat - report I/O statistics.iostat(l) 

IOT fault, generate an .abort(3C) 

io_eoi_cti - set up I/O read termination character on special file .io_eol_ctl(3l) 

io__get_term reason () - determine how last read terminated .io_get_term_reason(3l) 

io_interrupt_cti () - enable/disable interrupts for the associated eid () .io_interrupt_ctl(3l) 

io_iock(), io_uniock() - lock and unlock an I/O interface.io_lock(3l) 

io_on interrupt () - device I/O interrupt (fault) control .io_on_interrupt(3l) 

io_reset () - reset an I/O interface.io_reset(3l) 

io_speed cti () - inform system of required transfer speed .io_speed_ctl(3l) 

io_timeout_cti () - establish a time limit for I/O operations.io_timeout_ctl(3l) 

io unlock () - unlock an I/O interface.io_lock(3l) 

io_width_cti () - set width (in bits) of data path.io_width_ctl(3l) 

ip - Internet Protocol .IP(7P) 

ip Multicast - Internet Protocol .IP(7P) 

IP multicast routing daemon .mrouted(lM) 

IP network tunnel driver .tun(4) 

IP port, bind socket to a privileged .bindresvport(3N) 

ipcrm - remove a message queue, semaphore set, or shared memory identifier.ipcrm(l) 

ipcs - report status of interprocess communication facilities.ipcs(l) 

ISA configuration tool .eisa config(lM) 

isainum() - character is alphanumeric.ctype(3C) 

is alpha () - character is al pha .ctype(3C) 

isascii () - character is 7-bit ASCI I code .ctype(3C) 

isascii () - character is 7-bit ASCI I code .wctype(3C) 

isastream() - determine if file descriptor refers to STREAMS device or STREAMS-based pipe . isastream(3C) 

isattyO - find name of a terminal .ttyname(3C) 

iscntri () - character is a control character.ctype(3C) 
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iscomsec - check if system has been converted to a trusted system.iscomsec(2) 

isdigit () - character is a digit.ctype(3C) 

isendwin () - determine whether a screen has been refreshed .isendwin(3X) 

isfinite() - floating-point finiteness macro.isfinite(3M) 

isgraph () - character is a visible character.ctype(3C) 

isgreater () - floating-point comparison macro (>).isgreater(3M) 

isgreaterequal () - floating-point comparison macro (>=) .isgreaterequal(3M) 

isinf () - test for infinity.isinf(3M) 

isi - initial system loader.isl(lM) 

isiess () - floating-point comparison macro (<) .isless(3M) 

isiessequai () - floating-point comparison macro (<=).islessequal(3M) 

isiessgreater () - floating-point comparison macro (o) .isiessgreater(3M) 

isiower () - character is lowercase.ctype(3C) 

isnan() - floating-point test for NaN .isnan(3M) 

isnormai () - floating-point test for normalized value.isnormal(3M) 

isprint () - character is a printing character .ctype(3C) 

ispunct () - character is punctuation .ctype(3C) 

isspace () - character is whitespace.ctype(3C) 

issue - /etc/issue identification file.issue(4) 

issue a shell command .system(3S) 

isunordered() - floating-point comparison macro (unordered) .isunordered(3M) 

isupper () - character is uppercase .ctype(3C) 

iswainum() - character is alphanumeric.wctype(3C) 

iswaipha () - character is alpha .wctype(3C) 

iswcntri () - character is a control character.wctype(3C) 

iswctype () - character has property defined by prop .wctype(3C) 

iswdigit () - character is a digit .wctype(3C) 

iswgraph () - character is a visible character.wctype(3C) 

iswiower () - character is lowercase.wctype(3C) 

iswprint () - character is a printing character .wctype(3C) 

iswpunct () - character is punctuation .wctype(3C) 

iswspace () - character is whitespace.wctype(3C) 

iswupper () - character is uppercase .wctype(3C) 

iswxdigit () - character is a hexadecimal digit.wctype(3C) 

isxdigit () - character is a hexadecimal digit.ctype(3C) 

is_iinetouched() - window refresh control functions.is_linetouched(3X) 

is„wintouched() - window refresh control functions.is_linetouched(3X) 

ITE (Internal Terminal Emulator) .glossary(9) 

itemap - load a keyboard mapping into the I nternal Terminal Emulator .itemap(lM) 

jO (), ji (), jn () - Bessel functions of the first kind.jO(3M) 

jl () - Bessel function .jO(3M) 

jn () - Bessel function .jO(3M) 

job control .glossary(9) 

job control, set process group ID for .setpgid(2) 

job control, uucp status inquiry and .uustat(l) 

job execution daemon .cron(lM) 

job file, prototype, for at .proto(4) 

jobs - list activejobs .csh(l) 

jobs - list activejobs.ksh(l) 

jobs - list activejobs.sh-posix(l) 

join corresponding lines of several files or subsequent lines of one file.paste(l) 

join - relational database operator.join(l) 

jukebox device drivers, SCSI .autochanger(7) 

justify lines left or right for NLS printing .nljust(l) 

keep track of remotely mounted file systems .mount(3N) 

kermit - communication software for serial and network connections .kermit(l) 

kernel capability, associate group with .setprivgrp(lM) 

kernel data structures and /etc/ioconfig consistency.ioinit(lM) 

kernel definition, display system.sysdef(lM) 

kernel .glossary(9) 

kernel memory and main memory image file.mem(7) 
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kernel memory based on symbol name, perform I/O on .kmem(7) 

kernel module administration .kmadmin(lM) 

kernel module, add, delete, update.kminstall(lM) 

kernel module, get information for a dynamically loaded .modstat(2) 

kernel module, unload on demand .moduload(2) 

kernel modules, change global search path for dynamically loadable.modpath(2) 

kernel modules, load on demand .modload(2) 

kernel modules, loadable, register or unregister, with the running kernel .kmmodreg(lM) 

kernel modules, update.kmupdate(lM) 

kernel statistics server.rstatd(lM) 

kernel system file, create .create_sysfile(lM) 

kernel, build a bootable HP-UX kernel or kernel modules .mk_kernel(lM) 

kernel, global symbol, get information for.getksym(2) 

kernel, loadable modules for running kernel during boot.loadmods(4) 

kernel, master kernel configuration information .master (4) 

kernel, remote, get performance data from.rstat(3N) 

key server, storing private encryption keys.keyserv(l) 

key, change user's secure RPC key .chkey(l) 

key, decrypt and store secret .keylogin(l) 

key, delete secret key stored with keyserv.keylogout(l) 

key, generate a DES encryption .makekey(l) 

key, get name of .keyname(3X) 

keyboard driver, HP-HIL cooked .hilkbd(7) 

keyboard mapping, loading into the Internal Terminal Emulator.itemap(lM) 

keyboard, how to obtain control characters from.ascii(5) 

keyboard, PS/2 device driver.ps2(7) 

keyboard/display data order, convert file.forder(l) 

keyenvoy (1M) - talk to the keyserv process.keyenvoy(lM) 

keylogin - decrypt and store secret key .keylogin(l) 

keylogout - delete secret key stored with keyserv .keylogout(l) 

keyname () - get name of key .keyname(3X) 

keypad() - enabl^disable abbreviation of function keys.keypad(3X) 

keys in Network Information Service map, print the values of selected .ypmatch(l) 

keys, ppp encryption keys file format.ppp.Keys(4) 

keys, updatethe public keys in a NIS+directory object .nisupdkeys(lM) 

keyserv process, talk to the.keyenvoy(lM) 

keyserv - server for storing private encryption keys .keyserv(l) 

keysh - context-sensitive softkey shell.keysh(l) 

keysh softkey file format.softkeys(4) 

keywords, find manual information by; print out a manual entry .man(l) 

key decryptsession () -1ibrary routines for secure remote procedure calls.secure_rpc(3N) 

key encryptsession () -1 ibrary routi nes for secure remote procedure calls.secure_rpc(3N) 

key gendes () - library routines for secure remote procedure calls.secure_rpc(3N) 

key name () - get name of key .keyname(3X) 

key secretkey js set () - library routines for secure remote procedure calls.secure_rpc(3N) 

keyset secret () - library routines for secure remote procedure calls.secure_rpc(3N) 

kill a directory .rmdir(l) 

kill a file or directory .rm(l) 

kill line character .erasewchar(3X) 

kill - send signal to process; terminate process.kill(l) 

kill - send termination or specified signal to a process.csh(l) 

kill - terminatejob or process .ksh(l) 

kill - terminatejob or process .sh-posix(l) 

kill () - send signal to process or group of processes .ki 11 (2) 

kill () system call, 4.2 BSD-compatible.bsdproc(3C) 

kill () system call, 4.2 BSD-compatible .ki 11 pg(2) 

kiliaii - kill all active processes.killall(lM) 

kilichar () - single-byte line kill .erasechar(3X) 

killpgO - 4.2 BSD-compatible kill () system call .ki 11 pg(2) 

killsthesendmail daemon .killsm(lM) 

kilism- killsthesendmail daemon .kilism(lM) 
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kiiiwchar() -current linekill character .erasewchar(3X) 

kmadmin - kernel module administration .kmadmin(lM) 

kmem, kmem - kernel memory and main memory image file.mem(7) 

kmem - perform I/O on kernel memory based on symbol name.kmem(7) 

kminstaii - add, delete, update a kernel module.kminstall(lM) 

kmmodreg - register or unregister loadable kernel modules with the running kernel .kmmodreg(lM) 

kmsystem - set, query configuration and loadableflagsfor a module.kmsystem(lM) 

kmtune - query, set, or reset system parameter .kmtune(lM) 

kmupdate - update default kernel files or specified kernel modules.kmupdate(lM) 

known uucp systems, list names of.uucp(l) 

ksh - Korn shell command programming language.ksh(l) 

l - list directory contents in stream output format .Is(l) 

i3toi () - convert 3-byte integer to long integer .l3tol(3C) 

164a() - convert long integer to base-64 valueASCII string.a64l(3C) 

I64a_r () - convert between long integer and base-64ASCII string .a64l(3C) 

label checking, copy file systems with .volcopy(lM) 

label checking, copy file systems with .volcopy_hfs(lM) 

label checking, VxFS filesystem .volcopy_vxfs(lM) 

label, define for formatting routines .setlabel(3) 

label, soft, functions.slk_attrofF(3X) 

labelit - copy file systems with label checking.volcopy(lM) 

labelit - copy file systems with label checking.volcopy_hfs(lM) 

labelit - label for VxFS filesystem .volcopy_vxfs(lM) 

labs () - return long integer absolutevalue.abs(3C) 

LAN administration .lanadmin(lM) 

LAN connectivity, verify with link-level loopback.linkloop(lM) 

LAN device configuration and status, display.lanscan(lM) 

lan - network I/O card access information .Ian(7) 

LAN, log in on a remote system over.vt(l) 

lanadmin - local area network administration.lanadmin(lM) 

lang - description of supported languages.Iang(5) 

lang .glossary (9) 

langinfo - language information constants.langinfo(5) 

Language I/O (NLIO) Subsystem, Native.nlio(5) 

language information constants.langinfo(5) 

language macro processor .m4(l) 

language, configure on multi-language systems .geocustoms(lM) 

language: arbitrary-precision arithmetic language.bc(l) 

language: C language preprocessor .cpp(l) 

language: text pattern scanningand processing language.awk(l) 

languages, description of supported.Iang(5) 

languages, NLS information about native(local).nl_langinfo(3C) 

lanscan - display LAN device configuration and status.lanscan(lM) 

largeargument list(s), construct, and execute command .xargs(l) 

large files, find differences between.bdiff(l) 

large letters, make posters in .banner(l) 

large strings, generate hashing encryption on.bigcrypt(3C) 

last commands executed, show in reverse order .lastcomm(l) 

last I/O read, determine how terminated .io_get_term_reason(3l) 

last - indicate last logins of users and ttys .last(l) 

last locations of allocated regions in program.end(3C) 

last login date, show for each user .acctsh(lM) 

last logins of users and ttys, indicate.last(l) 

last part of a file, get lines from .tail(l) 

lastb - indicate last bad logins of users and ttys.last(l) 

lastcomm - show last commands executed in reverse order .lastcomm(l) 

lastiogin - show last login date for each user.acctsh(lM) 

lc - list directory contents.Is(l) 

lckpwdf () - control access to/etc/passwd file.lckpwdf(3C) 

id - link editor .Id(l) 

ldd -1ist dynamic dependencies of executablefiles or shared libraries.Idd(l) 
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ldecvt (), Lldecvt ()) - convert long doubleto string .ldcvt(3C) 

ldexp - load exponent of a floating-point number .ldexp(3M) 

ldfcvt (), (_ldfcvt ()) - convert long doubleto string .ldcvt(3C) 

ldgcvt (), (_ldgcvt ()) - convert long doubleto string .ldcvt(3C) 

ldiv() - long integer division and remainder.div(3C) 

ldterm - STREAMS terminal linedisciplinemodule.Idterm(7) 

Idterm, set and get EUC code widths for.eucset(l) 

leave - remind you when you have to leave.leave(l) 

leaveok () - terminal output control functions.clearok(3X) 

left or right justify linesfor NLS printing .nljust(l) 

Ieft-to-right text character sequence in each lineofafile, reverse the .rev(l) 

legal login shells, list of.shells(4) 

legal user shells, get.getusershell(3C) 

length limited string of single-byte characters and renditions to a window, add.addchnstr(3X) 

length of string, find .string(3C) 

length of wide string, find .wcstring(3C) 

let - evaluatearithmeticexpression .ksh(l) 

let - evaluatearithmetic expression .sh-posix(l) 

letters, make posters in large.banner(l) 

ifind() - linear search and update.lsearch(3C) 

lgamma(), lgamma r(), gamma (), signgam() - log gamma function . lgamma(3M) 

lgamma_r (), gamma (), signgam (), lgamma () - log gamma function . lgamma(3M) 

libcrash - crash dump acess library.Iibcrash(5) 

libcrash error or warming message, print.cr_perror(3) 

iibiu 62 .a - IBM APPC (Advanced Program-to-Program Communications) API .seesna(l) 

librariesand object files, generatesingleexecutablefilefrom .Id(l) 

libraries and subroutines, introduction.intro(3) 

library and application versions, coordinate for ELF .elf_version(3E) 

library file, link editor and assembler.a.out(4) 

library .glossary(9) 

library routine for manipulating global RPC attributefor client and server applications.rpc_control(3N) 

library routines for client side calls.rpc_clnt_calls(3N) 

library routines for client side remote procedure call authentication .rpc_clnt_auth(3N) 

library routines for creation and manipulation of CLIENT handles .rpc_clnt_create(3N) 

library routines for dealing with creation and manipulation of CLIENT handles.rpc_clnt_create(3N) 

library routines for external data representation.xdr(3N) 

library routines for external data representation .xdr_admin(3N) 

library routines for external data representation.xdr_complex(3N) 

library routines for external data representation .xdr_simple(3N) 

library routines for external data representation stream creation.xdr_create(3N) 

library routines for registering servers, rpc .rpc_svc_reg(3N) 

library routines for remote procedure calls.rpc(3N) 

library routines for remote procedure calls, XDR.rpc_xdr(3N) 

library routines for RPC bind service.rpcbind(3N) 

library routines for RPC servers.rpc_svc_calls(3N) 

library routines for RPC, obsolete .rpc_soc(3N) 

library routines for secure remote procedure calls.secure_rpc(3N) 

library routines for server side remote procedure call errors.rpc_svc_err(3N) 

library routines for thecreation of server handles, rpc .rpc_svc_create(3N) 

library structure for transport function argument structures (X/OPEN TLI-XTI) .t_alloc(3) 

library, audio.seeaudio(5) 

library, packed decimal, H P 3000-mode.hppac(3X) 

library: crash dump acess library.Iibcrash(5) 

library: object fileaccess library.elf(3E) 

licenselevel of operatingsystem, display .uname(l) 

licenselevel of operati ng system, get.uname(2) 

license server, start .i4lmd(lM) 

LicensePower/iFOR licensing.i4admin(lM) 

LicensePower/iFOR server start tool .i4start(lM) 

LicensePower/iFOR server stop tool .i4stop(lM) 

licensing, LicensePower/iFOR .i4admin(lM) 
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LIF directory, list contents of a .lifls(l) 

LI F files, copy to or from.lifcp(l) 

LIF files, list contents of a LIF directory .lifls(l) 

LIF files, remove. lifrm(l) 

LIF files, rename .lifrename(l) 

LIF files, writeLIF volume header on file .lifinit(l) 

LIF .glossary(9) 

lif - logical interchange format description.Iif(4) 

lifcp - copy to or from LIF files.lifcp(l) 

lifinit - writeLIF volume header on file.lifinit(l) 

lif is - list contents of a LIF directory .lifls(l) 

lifrename - rename LI F files .lifrename(l) 

lifrm - remove a LIF file .lifrm(l) 

limit for I/O operations, set time.io_timeout_ctl(3l) 

limit - limit usage by current process.csh(l) 

limit, get or set system resource consumption .getrlimit(2) 

limits - implementation-specific constants.Iimits(5) 

limits, disk usage.quota(5) 

lineconnection, establish an out-bound terminal .dial(3C) 

line control functions, tty.tccontrol(3C) 

line control, asynchronous serial modem .modem(7) 

line from standard input, read a .read(l) 

line.glossary(9) 

line kill character .erasewchar(3X) 

line kill character, single-byte .erasechar(3X) 

line number and symbol information, strip from an object file .strip(l) 

line numbering filter . nl(l) 

line numbers, add in front of each line in a file.nl(l) 

line on FHP-IB, control the Remote Enable.hpib_ren_ctl(3l) 

line printer daemon for LP requests from remote systems.rlpdaemon(lM) 

line printer device files .Ip(7) 

line printer .see printer 

Ii ne pri nter spool ing system .see L P 

line - read one line from user input .line(l) 

line speed, datacomm, and terminal settings used by getty .gettydefs(4) 

line update status functions.redrawwin(3X) 

line, dedicated, reserve for a purpose .ripoffline(3X) 

line, get X.25 . getx25(lM) 

line, single, input from user keyboard .line(l) 

line, SRQ, on FIP-IB, allow interface to enable.hpib_rqst_srvce(3l) 

line-feeds, remove multiplefrom output.ssp(l) 

line-feeds, reverse, and backspaces, remove from text .col(l) 

line-oriented text editor .ed(l) 

line-oriented text editor .ex(l) 

line-printer or CRT output, format text filefor .nroff(l) 

linear tablesearch with optional update.lsearch(3C) 

lines common to two sorted files, reject/select .comm(l) 

lines in a file, count .wc(l) 

lines in a file, cut out (extract) selected fields of.cut(l) 

lines in a file, report adjacent repeated .uniq(l) 

lines - number of lines on terminal screen .LINES(3X) 

lines of GPIO card, return status.gpio_get_status(3l) 

lines on GPIO card, set control .gpio_set_ctl(3l) 

lines, delete or insert into a window .insdelln(3X) 

lines, draw from complex characters and renditions.hline_set(3X) 

lines, draw from single-byte characters and renditions .hline(3X) 

lines, insert into a window.insertln(3X) 

lines, justify left or right for NLS printing .nljust(l) 

lines, long, fold for finite-width output device.fold(l) 

lines, merge corresponding lines of several files or subsequent lines of one file .paste(l) 

lines, number of, on terminal screen .LINES(3X) 
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lines, reduce multiple adjacent blank to single blank line.ssp(l) 

lines, remove preprocessor .unifdef(l) 

link count .glossary(9) 

link directories using symbolic links .In(l) 

link editor and assembler output format .a.out(4) 

link editor .Id(l) 

link editor, find correct ordering of object code files for single pass .lorder(l) 

link - execute link () system call without error checks.link(lM) 

link existing file to new file name.In(l) 

link.glossary (9) 

link NIS+objects. nisln(l) 

link to a file, make a symbolic.symlink(2) 

link to root, primary swap, or dump volume, remove LVM logical volume .Ivrmboot(lM) 

link () - link additional name to an existing file .Iink(2) 

link () system call, execute without error checks.link(lM) 

link, file, symbolic (soft) .symlink(4) 

link, symbolic, read valueof.readlink(2) 

link-level loopback to verify LAN connectivity.linkloop(lM) 

linker .glossary(9) 

linking process, diagnostic information for dynamic linking.dlerror(3C) 

linkioop - verify LAN connectivity with link-level loopback.linkloop(lM) 

lio listio () - start a list of asynchronous I/O operations .lio_listo(2) 

list a special (I/O device) file .Issf(lM) 

list access control lists (ACLs) of files.Isacl(l) 

list access privileges for group .getprivgrp(l) 

list access rights to fiIe(s) .getaccess(l) 

list characteristics of nodes on FDDI ring.fddinet(lM) 

list contents of a LIF directory .lifls(l) 

list contents of directory.Is(l) 

list contents of DOS directories.dosls(l) 

list current processes .ps(l) 

list current system users .who(l) 

list device drivers in the system.Isdev(lM) 

list dynamic dependencies of executable files or shared libraries .Idd(l) 

list entries in sendmail mail queue.sendmail(lM) 

list file names and statistics for filesystem (generic) .ff(lM) 

list file names and statistics for H F S filesystem .ff_hfs(lM) 

list file names and statistics for VxFS file system.ff_vxfs(lM) 

list first few lines in a file .head(l) 

list lines from last part of a file .tail(l) 

list names of known uucp systems.uucp(l) 

list of allowed login shells .shells(4) 

list of network groups .netgroup(4) 

list of orderable FIP-UX manuals.manuals(5) 

list path name corresponding to i-number .ff_hfs(lM) 

list the contents of an NIS+directory .nisls(l) 

list user crontabfile.crontab(l) 

list users currently on the system.users(l) 

list which host is Network I nformation System server or map master .ypwhich(l) 

list, get group access.getgroups(2) 

list, initializegroup access.initgroups(3C) 

list, name, get entries from .nlist(3C) 

list, print formatted output of a varargs argument .vprintf(3S) 

list, set group access .setgroups(2) 

listen for connections on a socket .listen(2) 

listen () - listen for connections on a socket.listen(2) 

lists owners of outgoing network connections.owners(lM) 

lists selected attribute values.pdls(l) 

lists, access control, introduction to.acl(5) 

listusers - display user login data.listusers(lM) 

li - list directory contents in long format.Is(l) 
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lirint () - round to nearest long long function . 

llround () - round to long long function . 

in - link files and directories . 

oad exponent of a floating-point number . 

oad exponent of a radix-independent floating-point number. 

oad exponent of a radix-independent floating-point number. 

oad kernel modules on demand . 

oad module, retrieve name. 

oad operati ng system . 

oad shared library. 

oadableflagsfor a module, set and query . 

oadablekernel modules, register or unregister, with the running kernel 

oadablemodules for running kernel during boot. 

oaded module (program or shared libary) . 

oaded module (program or shared libary). 

oader, dynamic. 

oader, initial system. 

loadmods - loadable modules for running kernel during boot. 


(native) languages, NLS information about 

area network administration . 

communication domain protocol . 

customs. 

filesystem mount statistics. 

filesystem, restore incrementally . 

host, authorizing access from remote hosts and users 

LicensePower/iFOR target id, print information. 

machines (RPC version), show host status of . 

machines, show status of . 

machines, show who is logged in on . 

names, NIS+. 

network machines, determine who is logged in on . 

network packet routing, system support for. 

node, transfer NIS database from NIS server to. 

user, verify a remote user as a . 

dump of filesystem. 

eenvironment, generate 


oca 
oca 
oca 
oca 
oca 
oca 
oca 
oca 
oca 
oca 
oca 
oca 
oca 
oca 
oca 
oca 
oca 
oca 

locale - get locale-specific (NLS) information 

ocale of a program, get or set the. 

ocale, current, query numeric formatting conventions of. 

ocale-specific (NLS) information, get. 

locaieconv () - query numeric formatting conventions of current locale . 

locaiedef-command input script format and semantics. 

locaiedef - generate a localeenvironment . 

localedef scripts, symbolictranslation filefor . 

localization . 

localtime (), iocaitime_r () - convert date and time to local timezone 

locatea program file including aliases and paths. 

locatesource, binary, and/or manual files for program . 

location functions, window cursor. 

location information about NIS+servers. 

location of byte in memory, find . 

locations beyond allocated program regions, first . 

lock a POSIX semaphore . 

lock a POSIX semaphore without blocking. 

lock a semaphore. 

I ock access to /etc/passwd fil e. 

lock daemon, network . 

lock or attempt to lock a read-write lock for reading . 

lock or attempt to lock a read-write lock for writing . 

lock or try to lock a mutex. 

lock or unlock an I/O interface . 


Entry Name(Section) 

.llrint(3M) 

.llround(3M) 

.In(l) 

.ldexp(3M) 

.scalb(3M) 

.seal bn (3M) 

.modload(2) 

.dlgetname(3C) 

.boot(lM) 

.shl_load(3X) 

.kmsystem(lM) 

.kmmodreg(lM) 

.loadmods(4) 

.dlget(3C) 

.dlmodinfo(3C) 

.dld.sl(64) 

.isl(lM) 

.loadmods(4) 

.nl_langinfo(3C) 

.lanadmin(lM) 

.UNIX(7P) 

.glossary (9) 

.rmtab(4) 

.vxrestore(lM) 

.hosts.equiv(4) 

.i4target(lM) 

.rup(l) 

.ruptime(l) 

.rwho(l) 

.nis_local_names(3N) 

.rusers(l) 

.routing(7) 

.ypxfr(lM) 

.rcmd(3N) 

.vxdump(lM) 

.localedef(lM) 

.locale(l) 

.setlocale(3C) 

.localeconv(3C) 

.locale(l) 

.localeconv(3C) 

.localedef (4) 

.localedef(lM) 

.charmap(4) 

.glossary (9) 

.ctime(3C) 

.which(l) 

.whereis(l) 

.move(3X) 

.niscachemgr(lM) 

.memory(3C) 

.end(3C) 

.sem_wait(2) 

.sem_wait(2) 

.msem_lock(2) 

.lckpwdf(3C) 

.lockd(lM) 

pthread_rwlock_rdlock(3T) 

pthread)rwlock_wrlock(3T) 

.pthread_mutex_lock(3T) 

.io_lock(3l) 
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lock process address space .mlockall(2) 

lock process into memory after allocating data and stack space.datalock(3C) 

lock process, text, or data in memory .plock(2) 

lock - protect terminal from use by others.lock(l) 

lock segment in memory.mlock(2) 

lock terminal against use by others.lock(l) 

lockd - network lock daemon .lockd(lM) 

lockf () - provide semaphores and record locking on files.lockf(2) 

lockf 64 () - filesystem API to support large files.creat64(2) 

locking of streams within a multi-thread application, explicit.flockfile(3S) 

locking on files, provide semaphores and record .lockf(2) 

LOFS filesystem, mount .mountJofs(lM) 

log administration functions, NIS+.nis_ping(3N) 

log driver, receive error messages from the STREAMS log driver .strerr(lM) 

log driver: STREAMS .strlog(7) 

log files, remove outdated STREAMS error log files.strclean(lM) 

log gamma function.lgamma(3M) 

log in on another system over LAN .vt(l) 

log in to system.login(l) 

log messages and other information about RCS files, print.rlog(l) 

log of uucp and uux transactions, access summary .uucp(l) 

log system messages.syslogd(lM) 

log (), logf () - natural logarithm functions.log(3M) 

log, display the contents of NlS+transaction .nislog(lM) 

log, error, collect system diagnostic messages to form .dmesg(lM) 

log, mail, displays the last part of .mtail(lM) 

log, system, control .syslog(3C) 

loglO(), loglOf () - common logarithm functions .loglO(3M) 

loglOf (), loglO () - common logarithm functions .loglO(3M) 

loglpO - natural logarithm function .loglp(3M) 

iog2 (), iog2f () - logarithm base two functions.log2(3M) 

iog2f (), iog2 () - logarithm base two functions.log2(3M) 

logarithm base ten functions.loglO(3M) 

logarithm base two functions.log2(3M) 

logarithm function, natural .loglp(3M) 

logarithm functions, natural .log(3M) 

logb () - radix-independent exponent .logb(3M) 

logf (), log () - natural logarithm functions.log(3M) 

logfile, viewing and saving SAM .samlogviewer 

logged in on local machines, show who is .rwho(l) 

logged in on local network machines, determine who is .rusers(l) 

logged in users' accounting information file.utmpx(4) 

logger - make entries in the system log .logger(l) 

logging and tracing binary files, format .netfmt(lM) 

logging and tracing, configure subsystem database .nettlconf(lM) 

logging configuration file, network tracing and.nettlgen.conf(4) 

logging, control network .nettl(lM) 

logical interchange format description.Iif(4) 

Logical Interchange Format .glossary(9) 

logical volume (LVM), decrease physical extents allocated to.Ivreduce(lM) 

logical volume (LVM), prepare to be root, swap, or dump volume.Ivlnboot(lM) 

logical volume (LVM), stripe, increase space, increase mirrors.Ivextend(lM) 

logical volume characteristics (LVM), change .Ivchange(lM) 

logical volume in LVM volume group, create.Ivcreate(lM) 

logical volume.Ivm(7) 

Logical Volume Manager (LVM).Ivm(7) 

logical volume mirrors in LVM volume groups, synchronize stale .vgsync(lM) 

logical volumes (LVM), display information about .Ivdisplay(lM) 

logical volumes (LVM), merge two into one logical volume.Ivmerge(lM) 

logical volumes (LVM), prepare root file system for migration from partitions to .ivmmigrate(lM) 

logical volumes (LVM), synchronize stale mirrors in .Ivsync(lM) 
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logical volumes from LVM volume group, remove.Ivremove(lM) 

logical volumes, export an LVM volume group and its associated .vgexport(lM) 

logical volumes, split mirrored LVM logical volume into two.Ivsplit(lM) 

login data, display.logins(lM) 

login date, show last for each user .acctsh(lM) 

login directory .glossary(9) 

login directory.login(l) 

login environment, shell script to set up user's .profile(4) 

login .glossary(9) 

login information for rexec() and ftp .netrc(4) 

login name .login(l) 

login name of the user, get character-string.cuserid(3S) 

login name of user, obtain.logname(3C) 

login name, change.su(l) 

login name, get.logname(l) 

login password in Network Information System (NIS), change .yppasswd(l) 

login password, change .passwd(l) 

login server, remote.rlogind(lM) 

login shell, change default.chsh(l) 

login shells, list of allowed .shells(4) 

login - sign on; start terminal session.login(l) 

login - terminate login shell .csh(l) 

login when VHE home machine is not available.vhe altlog(lM) 

login, add a user .useradd(lM) 

login, delete a user .userdel(lM) 

login, display data for user.listusers(lM) 

login, modify a user .usermod(lM) 

login, remote .rlogin(l) 

login/logoff records, convert to per-session accounting records .acctcon(lM) 

logingroup file. login(l) 

logingroup - group access and identification file, grp.h.group(4) 

logins - display login data .logins(lM) 

logins of users and ttys, indicate last .last(l) 

logname environment variable.iogin(l) 

logname - get login name .logname(l) 

logname () - return login name of user .logname(3C) 

logout - terminate login shell .csh(l) 

long doublefloating-point number to string, convert .ldcvt(3C) 

long double-precision number, convert string to.strtold(3C) 

long file names, convert a file system to allow .convertfs(lM) 

long files, find differences between .bdiff(l) 

long integer to base-64ASCII string, convert .a64l(3C) 

long integer to string, convert.ltostr(3C) 

long integers and 3-byteintegers, convert between.l3tol(3C) 

long lines, fold for finite-width output device.fold(l) 

long long, round function .llround(3M) 

long long, round to nearest function .llrint(3M) 

long, round function.lround(3M) 

long, round to nearest function .lrint(3M) 

long jmp () - restore stack environment after non-local goto .setjmp(3C) 

longname () - get verbose description of current terminal .longname(3X) 

look for LVM volume groups on physical volumes .vgscan(lM) 

look up current user information .finger(l) 

look up symbol in shared library .shl_load(3X) 

lookup sources .service.switch(lM) 

loopback, link-level, to verify LAN connectivity.linkloop(lM) 

lorder - find ordering relation for an object code library.lorder(l) 

lost+found directory for fsck(lM), make a .mklost-tfound(lM) 

lower-case, translatecharactersto .conv(3C) 

lowercase, translate wide characters to.wconv(3C) 

lp - lineprinter device files.Ip(7) 
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lp - print requests on an LP printer .Ip(l) 

LP printer, allow or prevent queuing requests.accept(lM) 

LP printer, print/alter/cancel requests.Ip(l) 

LP printers, enable/disable.enable(l) 

LP requests, cancel from spooling queue on remote system .rcancel(lM) 

LP requests: daemon for LP requests from remote systems .rlpdaemon(lM) 

LP requests: print status information .Ipstat(l) 

LP requests: print status of requests sent to remote system for printing.ripstat(lM) 

LP requests: send LP request to a remote system.rlp(lM) 

LP spooler performance analysis information, print .Ipana(lM) 

LP spooling requests, move to a specified destination.Ipsched(lM) 

LP spooling scheduler, start or stop.Ipsched(lM) 

LP spooling system, configure the .Ipadmin(lM) 

lpadmin - configure the LP spooling system .Ipadmin(lM) 

lpait - alter requests on an LP printer .Ip(l) 

lpana - print LP spooler performance analysis information.Ipana(lM) 

lpfence - set LP spooling request priority fence.ipsched(lM) 

lpfliter - filters invoked by Ip interface scripts .Ipfilter(1) 

lpmove - move LP spooling requests to specified destination.Ipsched(lM) 

lprpp - laserjet filter.Ipfilter(l) 

lpsched - start the LP spooling request scheduler.Ipsched(lM) 

lpshut - stop the LP spooling request scheduler.Ipsched(lM) 

lpstat - print LP request status information.Ipstat(l) 

irand48 (), nrand48 () - generate long-integer pseudo-random numbers.drand48(3C) 

lrint () - round to nearest long function .lrint(3M) 

1 round () - round to long function.lround(3M) 

is - list directory contents.Is(l) 

lsaci - list access control lists (ACLs) of files.Isacl(l) 

lsdev - list device drivers in thesystem .Isdev(lM) 

lsearch (), ifind() - linear search and update.lsearch(3C) 

lseek () - move read/write file pointer; seek .Iseek(2) 

iseek64() - file system API to support large files.creat64(2) 

lsf - list directory contents, showing subdirectories and executablefiles.Is(l) 

lsr - recursively list directory contents and subtrees.Is(l) 

lssf - list a special (I/O device) file.Issf(lM) 

lstat/fstat/stat system call, data returned by .stat(5) 

lstat () - get symbolic link status.Istat(2) 

istat64() - filesystem API to support large files.creat64(2) 

lsx - list directory contents, sort across page instead of down.Is(l) 

ltoa () - convert long integer to ASCI I decimal .ltostr(3C) 

itoa_r() - convert long integer to ASCI I decimal (MT-Safe).ltostr(3C) 

itoi3 () - convert long integer to 3-byteinteger .l3tol(3C) 

ltostr () - convert long integer to string.ltostr(3C) 

itostr_r() - convert long integer to string (MT-Safe) .ltostr(3C) 

lvchange - change LVM logical volumecharacteristics .Ivchange(lM) 

lvcreate - create logical volumein LVM volume group .Ivcreate(lM) 

lvdisplay - display information about LVM logical volumes .Ivdisplay(lM) 

lvextend - stripe, increasespace, increasemirrorsfor LVM logical volume .Ivextend(lM) 

lvinboot - prepare LVM logical volume to be root, swap, or dump volume.Ivlnboot(lM) 

LVM (Logical Volume Manager).Ivm(7) 

LVM logical vol ume characteristics, change .Ivchange(lM) 

LVM logical volume link to root, primary swap, or dump volume, remove .Ivrmboot(lM) 

lvm - Logical Volume Manager (LVM).Ivm(7) 

LVM logical volume, decrease physical extents allocated to .Ivreduce(lM) 

LVM logical volume, prepare to be root, swap, or dump volume.Ivlnboot(lM) 

LVM logical volume, stripe, i ncrease space, i ncrease mi rrors.Ivextend(lM) 

LVM logical volumes, display information about .Ivdisplay(lM) 

LVM logical volumes, merge two into one logical volume.ivmerge(lM) 

LVM logical volumes, prepare root filesystem for migration from partitionsto .Ivmmigrate(lM) 

LVM logical volumes, synchronizestalemirrors in .Ivsync(lM) 

LVM physical vol ume group information file .Ivmpvg(4) 
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LVM physical volume to other physical volumes, move allocated physical extents from.pvmove(lM) 

LVM setup.Ivm(7) 

LVM volume group and its associated logical volumes, export .vgexport(lM) 

LVM volume group availability, set .vgchange(lM) 

LVM volume group configuration backup file, create or update.vgcfgbackup(lM) 

LVM volume group definition, remove from the system .vgremove(lM) 

LVM volume group, change characteristics and access path of physical volume in.pvchange(lM) 

LVM volume group, check or repair a physical volume in .pvck(lM) 

LVM volume group, create logical volume in.Ivcreate(lM) 

LVM volume group, create physical volume for usein .pvcreate(lM) 

LVM volume group, create.vgcreate(lM) 

LVM volume group, display information about physical volumes in.pvdisplay(lM) 

LVM volume group, extend by adding physical volumes.vgextend(lM) 

LVM volume group, import onto the system .vgimport(lM) 

LVM volume group, reduce by removing physical volumes.vgreduce(lM) 

LVM volume group, remove logical volumes from.Ivremove(lM) 

LVM volume groups, display information about .vgdisplay(lM) 

LVM volume groups, scan physical volumes for .vgscan(lM) 

LVM volume groups, synchronizestalelogical volume mirrors .vgsync(lM) 

LVM, split mirrored logical volumeintotwo logical volumes.Ivsplit(lM) 

lvmerge - merge two LVM logical volumes into one logical volume.Ivmerge(lM) 

lvmmigrate - prepare root filesystem for migration from partitionsto LVM logical volumes .. Ivmmigrate(lM) 

lvmpvg - LVM physical volume group information file .Ivmpvg(4) 

lvreduce - decrease physical extents allocated to LVM logical volume.Ivreduce(lM) 

lvremove - remove logical volumes from LVM volume group.Ivremove(lM) 

lvrmboot - remove LVM logical volume link to root, primary swap, or dump volume.Ivrmboot(lM) 

lvsplit - split mirrored LVM logical volumeinto two logical volumes.Ivsplit(lM) 

lvsync - synchronizestalemirrors in LVM logical volumes .Ivsync(lM) 

lwpstat - show FibreChannel Light Weight Protocol network status.Iwpstat(lM) 

m4 - macro processor.m4(l) 

machid - provide truth valueabout processor type .machid(l) 

machine identification, display.uname(l) 

machine identification, get .uname(2) 

machineinformation, change.setuname(lM) 

machineis not available, login when VHE home.vhe altlog(lM) 

machine number, display .uname(l) 

machine number, get .uname(2) 

machine-dependent programming values and constants.values(5) 

machines (RPC version), show host status of local .rup(l) 

machines, determine who is logged in on local network .rusers(l) 

machines, return information about users on remote.rnusers(3N) 

machines, show status of local .ruptime(l) 

machines, show who is logged in on local .rwho(l) 

machines, write to specified remote .rwall(3N) 

macro package for formatting documents, MM .mm(5) 

macro package for formatting manpages.man (5) 

macro processor for C, Ratfor and other programming languages.m4(l) 

macros and functions, floating-point environment .fenv(5) 

macros for handling device numbers, header fileof.mknod(5) 

macros for handling variableargument lists.stdarg(5) 

macros for handling variableargument lists.varargs(5) 

macros, check or print documents formatted using mm.mm(l) 

madvise () - advise system of process's expected paging behavior.madvise(2) 

magic - magic numbers for HP-UX implementations.magic(4) 

magic number .glossary(9) 

magnetic tape dump and restore protocol module, remote.rmt(lM) 

magnetictape manipulating program.mt(l) 

mail aliases file, rebuild database.newaliases(lM) 

mail environment variable.login(l) 

mail file.login(l) 

mail folder, read mail from specified.readmail(l) 
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mail folders, summarize by subject and sender .mailfrom(l) 

mail in the incoming mailbox file, print out .prmail(l) 

mail interface, batch .fastmail(l) 

mail log, displays the last part of.mtail(lM) 

mail message processing system, interactive.mailx(l) 

mail queue, list entries in sendmaiI.sendmail(lM) 

mail queue, printing.mailq(l) 

mail response: "I am not here" indication .vacation(l) 

mail - send mail to users or read mail .mail(l) 

mail traffic statistics, print.mailstats(l) 

mail - who is mine from?.from(l) 

mail, notify users of new .newmail(l) 

mail, read from specified mail folder.readmail(l) 

mail, screen-oriented interface .elm(l) 

mail, send over the I nternet .sendmail(lM) 

mailbox file, print out mail in theincoming.prmail(l) 

mailboxes, notify users of new mail in.newmail(l) 

mailer, convert binary fileto ASCII for transmission by.uuencode(l) 

mail from - summarize mail folders by subject and sender .mailfrom(l) 

mailq - prints the mail queue.mailq(l) 

maiistats - print mail traffic statistics.mailstats(l) 

maiix - interactive mail message processi ng system.mailx(l) 

main memory allocator .malloc(3C) 

main memory and kernel memory image file.mem(7) 

main memory space allocation, control.malloc(3C) 

main memory space usage, display .malloc(3C) 

maintain, update, and regenerate groups of programs.make(l) 

maintainer, archive and library, for portable archives.ar(l) 

maintaining cache location information about NlS+servers.niscachemgr(lM) 

major and minor device pair: STREAMS driver .clone(7) 

major number.glossary(9) 

make a delta (change) to an SCCS file.delta(l) 

make a directory file .mkdir(2) 

make a directory .mkdir(l) 

make a directory, special, or ordinary file .mknod(2) 

make a DOS directory.dosmkdir(l) 

make a FIFO special file.mkfifo(3C) 

make a file descriptor, for ELF files.elf_begin(3E) 

make a file system (generic) .mkfs(lM) 

make a lost+found directory for fsck(lM) .mklost-tfound(lM) 

make a makefile. mkmf(l) 

make a name for a temporary file.mktemp(l) 

make a Network Information System database .makedbm(lM) 

make a new file system (generic) .newfs(lM) 

make a new H FS filesystem .newfs_hfs(lM) 

make a shell archive package.shar(l) 

make a special (device) file.mksf(lM) 

make a string pointer for ELF files .elf_strptr(3E) 

make a symbolic link to a file.symlink(2) 

make a unique (usually temporary) filename.mktemp(3C) 

make an HFS filesystem .mkfs_hfs(lM) 

make FIFO (named pipe) special files .mkfifo(l) 

make - maintain, update, and regenerate groups of programs.make(l) 

make posters in large letters .banner(l) 

make unprintableand non-ASCII characters in a file visibleor invisible.vis(l) 

makecontext () - mani pul ate user contexts.makecontext(2) 

makedbm - make a Network I nformation System database.makedbm(lM) 

makefile, create a.mkmf(l) 

makekey - generate a DES encryption key .makekey(l) 

makemap - creates database maps for sendmai I .makemap(lM) 

maiiinfo () - display memory space usage.malloc(3C) 
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maiioc () - allocate block of main memory.malloc(3C) 

maiiopt () - control memory space allocation .malloc(3C) 

man(l), fix manual pages for faster viewing with .fixman(lM) 

man - find manual information by keywords; print out a manual entry .man(l) 

man - macros for formatting manpages.man (5) 

manage a binary search tree .tsearch(3C) 

manage hash search tables.hsearch(3C) 

manage system database of automatically pushed STREAMS modules.autopush(lM) 

manage the pathalias database, access and .uupath(l) 

manage, monitor, create, distribute, and install software.sd(5) 

management functions, for pad.newpad(3X) 

management, signal (sighold(), sigrelse(), sigignore()) . sighold(2V) 

management, signal (sigseto, sighold(), sigrelse(), sigignore(), sigpause()) . sigset(3C) 

Manager state information, get Terminal Session .tsm.info(l) 

manager, menu-driven system administration .sam(lM) 

manager, shell layer .shl(l) 

Manager, Terminal Session .tsm(l) 

manipulate connect accounting records .fwtmp(lM) 

manipulate crash dump data.crashutil(lM) 

manipulate device assignment databaseentry .getdvagent(3) 

manipulatedisk quotas.quotactl(2) 

manipulate flags for ELF files.elf_flag(3E) 

manipulatemagnetictape drive.mt(l) 

manipulate protected password databaseentry.getprpwent(3) 

manipulate routing tables manually.route(lM) 

manipulate section data for ELF files.elf_getdata(3E) 

manipulate system default databaseentry.getprdfent(3) 

manipulate terminal control databaseentry .getprtcent(3) 

manipulate user contexts.makecontext(2) 

manipulate, initialize, and test signal sets.sigsetops(3C) 

manipulation functions, NIS+groups.nis_groups(3N) 

manipulation routines, I nternet address .inet(3N) 

manpage, macro package for formatting.man (5) 

manpages, introduction .Introduction^) 

mantissa and exponent, split double-precision number into.frexp(3M) 

manual entries, macro package for formatting .man (5) 

manual entry files for given name, find location of .whereis(l) 

manual entry, print out a; find manual information by keywords .man(l) 

manual information by keywords, find; print out a manual entry .man(l) 

manual pages, on-line, create the cat files for.catman(lM) 

manually manipulate routing tables.route(lM) 

manuals - current list of FIP-UX documentation .manuals(5) 

manuals, list of orderable FIP-UX .manuals(5) 

map device i D to file path .devnm(3) 

map master, list which host is Network Information System server or .ypwhich(l) 

map object into virtual memory.mmap(2) 

map of ASCII character set.ascii(5) 

map security file, NIS .securenets(4) 

map stream pointer to file descriptor .fileno(3S) 

map, print all values in a Network Information Service .ypcat(l) 

map, print the values of selected keys in Network Information Service .ypmatch(l) 

map, query an NIS server for information about an NIS.yppoll(lM) 

map-mbone - multicast router connection mapper .map-mbone(lM) 

mapped fileor anonymous memory region, initializesemaphorein .msem_init(2) 

mapped file or anonymous region, remove semaphore in .msem_remove(2) 

mapped file, synchronizea .msync(2) 

mapped region, unmap a .munmap(2) 

mapper, multicast router connection .map-mbone(lM) 

mapper, universal addresses to RPC program number.rpcbind(lM) 

mapping access protections, modify memory .mprotect(2) 

mapping definitions, memory .mman(5) 
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mapping, physical memory address.iomap(7) 

maps, creates database maps for sendmail .makemap(lM) 

mark a thread as detached to reclaim its resources when it terminates.pthread_detach(3T) 

mark differences between two files .diffmk(l) 

mask for file creation, set and get permissions .umask(2) 

mask for file-creation, set access permissions mode.umask(l) 

mask, set current ignorablesignals.sigsetmask(2) 

mass storage media or device, test for recording integrity and proper operation .mediainit(l) 

master and slavepty, STREAMS, unlocking.unlockpt(3C) 

master driver, STREAMS .tels(7) 

master kernel configuration information.master (4) 

master - master kernel configuration information.master (4) 

master pty driver, STREAMS .ptm(7) 

master, list which host is Network I nformation System server or map .ypwhich(l) 

match filename patterns .fnmatch(3C) 

match routines for regular expressions.regexp(3X) 

matching routines, regular expression.regcomp(3C) 

math.h - floating-point environment macros and functions.fenv(5) 

math: absolute value functions.fabs(3M) 

math: arccosine functions (degrees).acosd(3M) 

math: arccosine functions.acos(3M) 

math: arcsine functions (degrees) .asind(3M) 

math: arcsine functions .asin(3M) 

math: arctangent functions (degrees) .atand(3M) 

math: arctangent functions.atan(3M) 

math: arctangent-and-quadrant functions.atan2(3M) 

math: arctangent-and-quadrant functions (degrees) .atan2d(3M) 

math: base-2 exponential function .exp2(3M) 

math: Bessel functions of the first kind.jO(3M) 

math: Bessel functions of the second kind.yO(3M) 

math: ceiling function.ceil(3M) 

math: common logarithm functions .loglO(3M) 

math: copysign functions.copysign(3M) 

math: cosine functions (degrees) .cosd(3M) 

math: cosine functions.cos(3M) 

math: cube root functions.cbrt(3M) 

math: decompose floating-point number.modf(3M) 

math: error function and complementary error function .erf(3M) 

math: Euclidean distance (hypotenuse) function .hypot(3M) 

math: exponential functions .exp(3M) 

math: exponential functions .expml(3M) 

math: extract mantissa and exponent from double-precision number .frexp(3M) 

math: floating-point classification macro .fpclassify(3M) 

math: floating-point comparison macro (<) .isless(3M) 

math: floating-point comparison macro (<=).islessequal(3M) 

math: floating-point comparison macro (o) .isiessgreater(3M) 

math: floating-point comparison macro (>) .isgreater(3M) 

math: floating-point comparison macro (>=) .isgr eater equal (3M) 

math: floating-point comparison macro (unordered) .isunordered(3M) 

math: floating-point finiteness macro.isfinite(3M) 

math: floating-point sign-determination macro .signbit(3M) 

math: floating-point test for infinity.isinf(3M) 

math: floating-point test for NaN .isnan(3M) 

math: floating-point test for normalized value.isnormal(3M) 

math: floor function .floor(3M) 

math: functions and constants.math(5) 

math: hyperbolic cosine functions .cosh(3M) 

math: hyperbolic sine functions.sinh(3M) 

math: hyperbolic tangent functions.tanh(3M) 

math: inverse hyperbolic cosine function.acosh(3M) 

math: inverse hyperbolic sine function .asinh(3M) 
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math: inverse hyperbolic tangent function .atanh(3M) 

math: load exponent of a floating-point number .ldexp(3M) 

math: load exponent of a radix-independent floating-point number.scalb(3M) 

math: load exponent of a radix-independent floating-point number .seal bn (3M) 

math: log gamma function .lgamma(3M) 

math: logarithm base two functions.log2(3M) 

math: maximum value function.fmax(3M) 

math: minimumvaluefunction.fmin(3M) 

math: natural logarithm function .loglp(3M) 

math: natural logarithm functions.log(3M) 

math: next representablefloating-point value.nextafter(3M) 

math: positive difference function .fdim(3M) 

math: power functions.pow(3M) 

math: pseudorandom number generation functions.random(3M) 

math: radix-independent exponent .logb(3M) 

math: remainder function.remainder(3M) 

math: remainder function with quotient.remquo(3M) 

math: remainder functions.fmod(3M) 

math: round function .round(3M) 

math: round to long function.lround(3M) 

math: round to long long function .llround(3M) 

math: round to nearest int functions.rint(3M) 

math: round to nearest long function .lrint(3M) 

math: round to nearest long long function .llrint(3M) 

math: sine functions (degrees).sind(3M) 

math: sinefunctions.sin(3M) 

math: square root functions.sqrt(3M) 

math: string-to-NaN conversion function .nan(3M) 

math: tangent functions (degrees).tand(3M) 

math: tangent functions.tan(3M) 

math: truncation function .trunc(3M) 

math: unbiased exponent function.ilogb(3M) 

mathematical text, preprocess and format for nroff.neqn(l) 

maximum valuefunction.fmax(3M) 

mbien () - number of bytes in the multibyte character .multibyte(3C) 

mbstowcs () - convert sequence of multibyte characters .multibyte(3C) 

mbtowc () - number of bytes in the multibyte character .multibyte(3C) 

me - media changer manipulation utility.mc(lM) 

merto. o, erto. o - C and Pascal execution startup routines .crt0(3) 

measure time used to execute a command.time(l) 

measure, convert units of.units(l) 

media changer device driver, SCSI .autochanger(7) 

media changer manipulation utility.mc(lM) 

mediainit - initialize hard disk, flexi ble disk, or cartridge tape media.mediainit(l) 

mem, kmem - main memory and kernel memory image file.mem(7) 

memberships, show group.groups(l) 

memccpy () - copy bytes from memory to another memory location .memory(3C) 

memchr () - find first occurrence of byte in memory area .memory(3C) 

memempo - compare byte with memory contents.memory(3C) 

memepy () - copy bytes from memory to another memory location .memory(3C) 

memmove () - move memory contents .memory(3C) 

memory address mapping, physical .iomap(7) 

memory allocator for main memory .malloc(3C) 

memory control operations, shared .shmctl(2) 

memory for library structure (X/OPEN TLI-XTI) .t_free(3) 

memory image file, main memory and kernel .mem(7) 

memory mapping access protections, modify .mprotect(2) 

memory mapping definitions.mman(5) 

memory operations - copy, compare, test for contents, or set contents to value.memory(3C) 

memory region, initializesemaphore in mapped file or anonymous.msem_init(2) 

memory segment, get shared.shmget(2) 
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memory statistics, report virtual .vmstat(l) 

memory, copy a file into.copylist(3C) 

memory, lock process address space in.mlockall(2) 

memory, lock process into after allocatingdata and stack space.datalock(3C) 

memory, lock process, text, data, stack, or shared library in .plock(2) 

memory, lock segment in.mlock(2) 

memory, map object into virtual.mmap(2) 

memory, perform I/O on kernel memory based on symbol name .kmem(7) 

memory, unlock segment .munlock(2) 

memory, unlock virtual address space.munlockall(2) 

memorymapO - display contents of memory allocator .malloc(3C) 

memset () - set area in memory to contain a specified byte .memory(3C) 

menu-driven system administration manager.sam(lM) 

merge and/or sort files .sort(l) 

merge corresponding lines of several files or subsequent lines of one file.paste(l) 

merge or add total accounting files .acctmerg(lM) 

merge RCS revisions.rcsmerge(l) 

merge - three-way file merge .merge(l) 

merge two LVM logical volumes into one logical volume.Ivmerge(lM) 

mesg - permit or deny write(l) messages from other users to terminal .mesg(l) 

message catalog file, create for modification .findmsg(l) 

message catalog file, extract messages from .findmsg(l) 

message catalog file, generate a formatted .gencat(l) 

message catalog for reading, close or open NLS .catopen(3C) 

message catalog.glossary(9) 

message catalog, set the default.setcat(3) 

message catalogs, find strings for inclusion in .findstr(l) 

message control operations.msgctl(2) 

message file, read text string from .gettxt(3C) 

message fil es, create for use by gettxt () .mkmsgs(l) 

message from a socket, receive.recv(2) 

message operation permissions.glossary(9) 

message operations.msgop(2) 

message processing system, interactive mail .mailx(l) 

message queue descri ptor, close.mq_close(2) 

message queue identifier (msqid).glossary(9) 

message queue identifier, remove.ipcrm(l) 

message queue, create/open.mp_open(2) 

message queue, get.msgget(2) 

message queue, receive a message .mq_receive(2) 

message queue, register/cancel a notification request with a message queue.mq_notify(2) 

message queue, send a message.mq_send(2) 

message queue, set the blocking status .mq_setattr(2) 

message queue, unlink.mq_unlink(2) 

message queues, report status .ipcs(l) 

message transcription system .answer(l) 

message, broadcast simultaneously to all users .wall(lM) 

message, display in stadard format .pfmt(3C) 

message, NLS program, get an .catgets(3C) 

message, print libcrash error or warming message.cr_perror(3) 

message, send a message on a stream.putmsg(2) 

message, send or receive message queue message .msgop(2) 

message, send to a socket .send(2) 

messages from other users to terminal, deny or permit write(l).mesg(l) 

messages from system, log.syslogd(lM) 

messages to system log, send .logger(l) 

messages, diagnostic, collect to form system error log .dmesg(lM) 

messages, display NIS+ error .nis_error(3N) 

messages, error, extract from C source into a file .mkstr(l) 

messages, system error.perror(3C) 

meta () - enable/disable meta-keys .meta(3X) 
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meta-keys, enable/disable.meta(3X) 

metacharacter .glossary(9) 

metric system, convert units to or from .units(l) 

mfrto.o, frto . o - FORTRAN execution startup routines .crt0(3) 

migration from partitions to LVM logical volumes, prepare root file system for .Ivmmigrate(lM) 

MIME (Multipurpose Internet Mail Extensions) .elm(l) 

minimum I/O data transfer rate, inform system of required .io_speed_ctl(3l) 

minimum valuefunction.fmin(3M) 

minor and major device pair: STREAMS driver .clone(7) 

minor number .glossary(9) 

mirrored LVM logical volume, split into two logical volumes.Ivsplit(lM) 

mirrors for LVM logical volume, increase.Ivextend(lM) 

mirrors in LVM logical volumes, synchronize stale .Ivsync(lM) 

mirrors in LVM volume groups, synchronize stale logical volume .vgsync(lM) 

miscellany, introduction to .intro(5) 

mkboot - install, or update boot programs from a disk device.mkboot(lM) 

mkdir - make a directory .mkdir(l) 

mkdir () - make a directory file.mkdir(2) 

mkdirpo - create directories in a path.mkdirp(3G) 

mkfifo - make FIFO (named pipe) special files .mkfifo(l) 

mkfifo () - make a FIFO special file .mkfifo(3C) 

mkfs - construct a file system (generic) .mkfs(lM) 

mkfs - construct an FIFS filesystem .mkfs_hfs(lM) 

mkfs - construct VxFS filesystem .mkfs_vxfs(lM) 

mkfs_vxfs - construct VxFS filesystem .mkfs_vxfs(lM) 

mkiost+found - make a lost+found directory for fsck(lM) .mkiost-tfound(lM) 

mkmf - make a makefile .mkmf(l) 

mkmsgs - create message files for use by gettxt () .mkmsgs(l) 

mknod - create special and FIFO files .mknod(lM) 

mknod() - make directory, special, or ordinary file.mknod(2) 

mknod. h - header file of macros for handling device numbers.mknod(5) 

mkpdf - create Product Description Filefrom an input .mkpdf(lM) 

mksf - make a special (device) file.mksf(lM) 

mkstr - extract error messages from C source into a file.mkstr(l) 

mktemp - make a name for a temporary file.mktemp(l) 

mktempo - make a unique (temporary) filename.mktemp(3C) 

mktime () - convert time into calendar time value.ctime(3C) 

mktimer () - al locate a per-process ti mer.mktimer(3C) 

mkuupath, uupath - access and manage the pathalias database.uupath(l) 

mk kernel - build a bootable FIP-UX kernel or kernel modules.mk_kernel(lM) 

miock () - lock segment of process address space in memory .mlock(2) 

miockaii () - lock all process address space in memory .mlockail(2) 

MM macro package for formatting documents.mm(5) 

mm - print or check documents formatted with the mm macros .mm(l) 

mm - the MM macro package for formatting documents.mm(5) 

mmap() - map object into virtual memory .mmap(2) 

mmap64() - file system API to support large files.creat64(2) 

mnttab, establish mount table/etc/mnttab.setmnt(lM) 

mnttab - mounted file system table.mnttab(4) 

mode .glossary(9) 

mode mask for file-creation, set access permissions.umask(l) 

mode, change file access permissions.chmod(l) 

mode, change file access permissions.chmod(2) 

mode, EOI, for FIP-IB file, control .hpib_eoi_ctl(3l) 

mode, place system in single-user.shutdown(lM) 

mode, set the cursor mode .curs_set(3X) 

model - FIP-UX machine identification .model (4) 

model - print name of current FIP-UX version.model(1) 

model, print name of current FIP-UX.model(1) 

modem - asynchronous serial modem line control .modem(7) 

modem capability database.terminfo(4) 
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modem line control, asynchronous serial .modem(7) 

modest-sized programs, compiler/interpreter for.bs(l) 

modf () - decompose floating-point number.modf(3M) 

modification times, set or updatefile.utime(2) 

modification, access, and/or change times of a file, update.touch(l) 

modification, create message catalog file for .findmsg(l) 

modifies attributes of submitted print jobs .pdmod(l) 

modifies attributes of submitted print jobs.pdset(l) 

modify a group on the system .groupmod(lM) 

modify a user login on the system.usermod(lM) 

modify and delete user credentials for an authentication service.pam_setcred(3) 

modify and display variables in the stable storage.setboot(lM) 

modify environment for command execution.env(l) 

modify memory mapping access protections .mprotect(2) 

modify or view Access Control Lists.swacl(lM) 

modify selected characters.tr(l) 

modify, add, or delete access control list entry .setaclentry(3C) 

modify, delete, copy, add, or summarize file access control lists (ACLs) .chacl(l) 

modifying Network Information Servicepasswd database, daemon for .yppasswdd(lM) 

modioad() - load kernel modules on demand .modload(2) 

modpath() - change global search path for dynamically loadablekernel modules .modpath(2) 

modstat () - get information for a dynamically loaded kernel module.modstat(2) 

module, Emulation for STREAMS pty .ptem(7) 

module, Packet Mode, for STREAM pty .pckt(7) 

module, PAM user policy definition service .pam_updbe(5) 

module, remote magnetic tape dump and restore protocol .rmt(lM) 

modules, loadable, for running kernel during boot.loadmods(4) 

moduioad() - unload a kernel moduleon demand .moduload(2) 

monacct - create periodic accounting summary files .acctsh(lM) 

monetary value to string, convert .strfmon(3C) 

monitor daemon, audit-overflow .audomon(lM) 

monitor I/O conditions on multi pie file descriptors .poll (2) 

monitor OSPF gateways .ospf monitor(lM) 

monitor profile data, display.prof(l) 

monitor uucp subnetwork activity.uusub(lM) 

monitor () - prepare execution profile.monitor(3C) 

monitor, create, distribute, install, and manage software.sd(5) 

monitor, network status.statd(lM) 

more - file perusal filter for crt viewing.more(l) 

motd file.login(l) 

mount a file system .vfsmount(2) 

mount and unmount CD-ROM filesystems.pfsmount(lM) 

mount and unmount VxFS filesystem .mount_vxfs(lM) 

mount - mount a filesystem (generic).mount(lM) 

mount - mount an LOFS filesystem .mountJofs(lM) 

mount - mount CDFS filesystems .mount cdfs(lM) 

mount - mount HFS filesystems .mount_hfs(lM) 

mount - mount NFS filesystems .mount_nfs(lM) 

mount - mount VxFS filesystem.mount_vxfs(lM) 

mount multi pie file systems .mountali(lM) 

mount NFS file systems automatically.automount(lM) 

mount request server, NFS .mountd(lM) 

mount request server, PFS.pfsmountd(lM) 

mount statistics, local filesystem .rmtab(4) 

mount table/etc/mnttab, establish.setmnt(lM) 

mount to remote file system, perform Network FileSystem .vhe_u_mnt(lM) 

mount () - mount a file system .mount(2) 

mountable file system.glossary(9) 

mountaii - mount multi pie file systems.mountali(lM) 

mountd: NFS mount request server .mountd(lM) 

mounted filesystem statistics, get.ustat(2) 
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mounted file system table.mnttab(4) 

mounted file systems, keep track of remotely .mount(3N) 

mounts, show all remote .showmount(lM) 

mount vxfs - mount and unmount VxFS filesystem .mount_vxfs(lM) 

mouse, PS/2 device driver .ps2(7) 

move a directory (requires super-user) .mvdir(lM) 

move allocated physical extents from one LVM physical volume to other physical volumes .pvmove(lM) 

move file to new location.mv(l) 

move files between systems.ftp(l) 

move LP spooling requests to a specified destination .Ipsched(lM) 

move magnetic tape forward or backward by files or records.mt(l) 

move multiplefiles to another directory.mv(l) 

move read/write file pointer; seek .Iseek(2) 

move window. mvwin(3X) 

move () - window cursor location functions.move(3X) 

movement commands cursor, output to the terminal .mvcur(3X) 

mpcti () - multiprocessor control .mpctl(2) 

mprotect - modify memory mapping access protections.mprotect(2) 

mq_ciose() -dosea message queue descriptor.mq_close(2) 

mq_getattr () - get status information and attributes associated with a message queue .mq_getattr(2) 

mq_notify () - register/cancel a notification request with a message queue.mq_notify(2) 

mq_open() - create/open a message queue.mq_open(2) 

mq_receive () - receive a message from a message queue.mq_receive(2) 

mq_send () - send a message to a message queue.mq_send(2) 

mq_setattr() - set the blocking status of a message queue associated with descriptor.mq_setattr(2) 

mq_uniink() - unlink a message queue.mq_unlink(2) 

mrand48 (), jrand48 () - generate signed long-integer pseudo-random numbers.drand48(3C) 

mrinfo -multicast routing configuration information tool .mrinfo(l) 

mrouted -1P multicast routing daemon .mrouted(lM) 

msem init () - i nitializesemaphore i n mapped file or anonymous memory region .msem_init(2) 

msem lock - lock a semaphore .msem_lock(2) 

msem remove - remove semaphore in mapped file or anonymous region .msem_remove(2) 

msem unlock - unlock a semaphore.msem_unlock(2) 

msgcti () - message control operations.msgctl(2) 

msgget () - get message queue.msgget(2) 

msgrcv () - recei ve message from message queue .msgop(2) 

msgsnd () - send message to message queue .msgop(2) 

msqid (message queue identifier).glossary(9) 

msync - synchronize a mapped file.msync(2) 

mt - magnetic tape interface for stape, tapel, andtape2.mt(7) 

mt - magnetictape manipulating program.mt(l) 

mtab, mounted file systems table.pfs_fstab(5) 

mtaii - displays the last part of the mail log.mtail(lM) 

multi-byte character length limited string, get from theterminal .getnstr(3X) 

multi-byte character string, get from theterminal .getstr(3X) 

multi-byte character string, input from a window.innstr(3X) 

multi-byte character, insert into a window.insnstr(3X) 

multi-byte characters, add a string of, without rendition to a window and advance cursor .addnstr(3X) 

multi-language systems, configure system language.geocustoms(lM) 

multi-thread application, explicit locking of streams within a.flockfile(3S) 

multibytecharacters and strings conversions .multibyte(3C) 

multibyte () - multibytecharacters and strings conversions .multibyte(3C) 

multicast router connection mapper .map-mbone(lM) 

multicast routing configuration information tool .mrinfo(lM) 

multicast routing daemon, IP .mrouted(lM) 

multipleadjacent blank lines, reduce to single blank line.ssp(l) 

multi pi efil e systems, mount and unmount .mountall(lM) 

multiplefiles, split file into.csplit(l) 

multipleline-feeds, remove from output.ssp(l) 

multipie n-line pieces, split a file into.split(l) 

multiplexing, synchronous I/O .select(2) 

HP-UX Release 11.0: October 1997 Hewlett-Packard Company Index-91 
































































Index 
All Volumes 

Description Entry Name(Section) 

multiprocessor control .mpctl(2) 

Multipurpose Internet Mail Extensions (Ml ME) .elm(l) 

multithreaded process trace .ttrace(2) 

multiuser state.glossary(9) 

muniock () - unlock segment of process virtual address space .munlock(2) 

muniockaii () - unlock entire process virtual address space .munlockall(2) 

munmapt) - unmap a mapped region .munmap(2) 

mutex attribute object, initializeor destroy .pthread_mutexattr_init(3T) 


mutex, initializeand destroy .pthread_mutex_init(3T) 

mutex, lock or try to lock .pthread_mutex_lock(3T) 


mv- move or rename files and directories .mv(l) 

mvaddch () - add a single-byte character and rendition to a wi ndow and advance the cursor.addch(3X) 

mvaddchnstr () - add length limited string of single-byte characters and renditions to a window 

.addchnstr(3X) 

mvaddchstr () - add string of single-byte characters and renditions to a wi ndow.addchstr(3X) 

mvaddnstr () - add a string of multi-byte characters without rendition to a window and 

advance cursor.addnstr(3X) 

mvaddnwstr () - add a wide-character string to a wi ndow and advance the cursor.addnwstr(3X) 

mvaddstr () - add a string of multi-byte characters without rendition to a window and 

advance cursor.addnstr(3X) 

mvaddwstr () - add a wide-character string to a wi ndow and advance the cursor.addnwstr(3X) 

mvadd wch () - add a complex character and rendition to a window .add_wch(3X) 

mvadd wchnstr () - add an array of complex characters and renditions to a wi ndow.add_wchnstr(3X) 

mvadd wchstr () - add an array of complex characters and renditions to a wi ndow.add_wchnstr(3X) 

mvchgat () - change renditions of characters in a window.chgat(3X) 

mvcur () - output cursor movement commands to the terminal.mvcur(3X) 

mvdeich () - delete character from a window .delch(3X) 

mvderwin () - define wi ndow coordinate transformation .mvderwin(3X) 

mvdir - move a directory (requires super-user).mvdir(lM) 

mvgetch() - get a single-bytecharacter from theterminal.getch(3X) 

mvgetnstr () - get a multi-byte character length I imited string from the terminal .getnstr(3X) 

mvgetn_wstr () - get an array of wide characters and function key codes from a terminal .getn_wstr(3X) 

mvgetstr () - get a multi-byte character string from theterminal .getstr(3X) 

mvget wch () - get a wide character from a terminal .get_wch(3X) 

mvget wstr () - get an array of wide characters and function key codes from a terminal.getn_wstr(3X) 

mvhiine () - draw lines from single-bytecharacters and renditions.hline(3X) 

mvhiine set () - draw lines from complex characters and renditions.hline_set(3X) 

mvinch () - input a single-bytecharacter and rendition from a window.inch(3X) 

mvinchnstr () - i nput an array of single-byte characters and renditions from a wi ndow .inchnstr(3X) 

mvinchstr () - i nput an array of single-byte characters and renditions from a wi ndow .inchnstr(3X) 

mvinnstr () - i nput a multi-byte character string from a wi ndow .innstr(3X) 

mvinnwstr () - input a string of wide characters from a window.innwstr(3X) 

mvinsch () - insert a single-bytecharacter and rendition into a window.insch(3X) 

mvinsnstr () - insert a multi-byte character into a window.insnstr(3X) 

mvinsstr () - insert a multi-byte character into a window.insnstr(3X) 

mvinstr () - i nput a multi-byte character string from a wi ndow .innstr(3X) 

mvins nwstr () - insert a wide-character string into a window.ins_nwstr(3X) 

mvins wch () - insert a complex character and rendition into a window.ins_wch(3X) 

mvins wstr () - insert a wide-character string into a window.ins_nwstr(3X) 

mvinwstr () - i nput a string of wide characters from a wi ndow.innwstr(3X) 

mvin__wch () - input a complex character and rendition from a window .in_wch(3X) 

mvin_wchnstr () - input an array of complex characters and renditions from a window.in_wchnstr(3X) 

mvin__wchstr () - i nput an array of complex characters and renditions from a wi ndow.in_wchnstr(3X) 

mvprintw() - print formatted output in window .mvprintw(3X) 

mvscanw () - convert formatted input from a window.mvscanw(3X) 

mwiine () - draw lines from single-bytecharacters and renditions.hline(3X) 

mwi i nes et () - draw lines from complex characters and renditions.hline_set(3X) 

mvwaddch () - add a single-byte character and rendition to a wi ndow and advance the cursor.addch(3X) 

mvwaddchnstr () - add length limited string of single-bytecharacters and renditions to a window 
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.addchnstr(3X) 

mvwaddchstr () - add string of single-byte characters and renditions to a window.addchstr(3X) 

mvwaddnstr () - add a string of multi-byte characters without rendition to a window and 

advance cursor.addnstr(3X) 

mvwaddnwstr () - add a wide-character string to a wi ndow and advance the cursor .addnwstr(3X) 

mvwaddstr () - add a string of multi-byte characters without rendition to a window and 

advance cursor.addnstr(3X) 

mvwaddwstr () - add a wide-character string to a wi ndow and advance the cursor.addnwstr(3X) 

mvwadd wch () - add a complex character and rendition to a window .add_wch(3X) 

mvwadd wchnstr () - add an array of complex characters and renditions to a window.add_wchnstr(3X) 

mwadd wchstr () - add an array of complex characters and renditions to a window.add_wchnstr(3X) 

mvwchgat () - change renditions of characters in a window.chgat(3X) 

mvwdeich () - delete character from a window .delch(3X) 

mvwgetch () - get a single-byte character from theterminal.getch(3X) 

mvwgetnstr () - get a multi-byte character length limited stringfrom theterminal .getnstr(3X) 

mvwgetn_wstr () - get an array of wide characters and function key codes from a terminal .getn_wstr(3X) 

mvwgetstr () - get a multi-byte character stringfrom theterminal .getstr(3X) 

mvwget wch () - get a wide character from a terminal .get_wch(3X) 

mvwget_wstr () - get an array of wide characters and function key codes from a terminal .getn_wstr(3X) 

mvwhiine () - draw li nes from single-byte characters and renditions .hline(3X) 

mvwhiine set () - draw lines from complex characters and renditions.hline_set(3X) 

mvwin () - move window.mvwin(3X) 

mvwinch () - input a single-byte character and rendition from a window.inch(3X) 

mvwinchnstr () - i nput an array of single-byte characters and renditions from a wi ndow .inchnstr(3X) 

mvwinchstr () - input an array of single-byte characters and renditions from a wi ndow .inchnstr(3X) 

mvwinnstr () - input a multi-byte character stringfrom a window .innstr(3X) 

mvwinnwstr () - input a string of wide characters from a window.innwstr(3X) 

mvwinsch () - insert a single-bytecharacter and rendition into a window.insch(3X) 

mvwinsnstr () - insert a multi-byte character into a window.insnstr(3X) 

mvwinsstr () - insert a multi-byte character into a window.insnstr(3X) 

mvwinstr () - i nput a multi-byte character string from a wi ndow .innstr(3X) 

mvwins_nwstr () - insert a wide-character string into a window.ins_nwstr(3X) 

mvwins wch () - insert a complex character and rendition into a window.ins_wch(3X) 

mvwins„wstr () - insert a wide-character string into a window.ins_nwstr(3X) 

mvwinwstr () - i nput a string of wide characters from a wi ndow.innwstr(3X) 

mvwin wch () - input a complex character and rendition from a window .in_wch(3X) 

mvwin wchnstr () - i nput an array of complex characters and renditions from a wi ndow.in_wchnstr(3X) 

mvwin wchstr () - input an array of complex characters and renditions from a window.in_wchnstr(3X) 

mvwprintw() - print formatted output in window .mvprintw(3X) 

mvwscanw () - convert formatted input from a window.mvscanw(3X) 

mvwvline () - draw lines from single-bytecharacters and renditions.hline(3X) 

mvwvline set () - draw lines from complex characters and renditions.hline_set(3X) 

name database, network.networks(4) 

name database, service.services(4) 

name for a temporary file, make.mktemp(l) 

name list (symbol table) of object codefile, print.nm(l) 

name of a file, change.mv(l) 

name of a slave pty, get the.ptsname(3C) 

name of current host system, set or display .hostname(l) 

name of current HP-UX model, print.model (1) 

name of current NIS domain, get or set .getdomainname(2) 

name of device.devnm(lM) 

name of file owner or group, change.chown(l) 

name of key, get .keyname(3X) 

name of operating system, display.uname(l) 

name of operating system, get.uname(2) 

name of the user's terminal or pseudo-terminal, get.tty(l) 

name server file format, translatehost tableto.hosts_to_named(lM) 

name server, domain, send signalsto .signamed(lM) 

name server, Internet domain.named(lM) 

name servers, query interactively .nslookup(l) 
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Name Service Switch backend libraries, query .nsquery(l) 

name service: new version .nis-Kl) 

namespace: attach a STREAMS file descriptor.fattach(3C) 

name, change login .su(l) 

name, get disk description by its.getdiskbyname(3C) 

name, get login.logname(l) 

name, print working directory.pwd(l) 

name, set or display Network I nformation Service domain.domainname(l) 

name, user, PAM routine to retrieve.pam_get_user(3) 

name-service switch, configuration filefor.nsswitch.conf(4) 

name-to-address translation, generic transport .netdir(3N) 

name: change the name of a file.rename(2) 

name: create a name for a temporary file.tmpnam(3S) 

name: detach a name from a STREAMS-based file descriptor.fdetach(3C) 

name: find name of a terminal .ttyname(3C) 

name: get character-string representation of user login name.cuserid(3S) 

name: get entries from namelist.nlist(3C) 

name: get name from UID (obsolete) .getpw(3C) 

name: get name of current host .gethostname(2) 

name: obtain user login name.logname(3C) 

name: set the name of host cpu .sethostname(2) 

named -1 nternet domain name server .named(lM) 

named pipes, create.mknod(lM) 

named-xfer - ancillary agent for inbound zone transfers .named-xfer(lM) 

names and statisticsfor HFS filesystem, list file .ff_hfs(lM) 

names database, host.hosts(4) 

names from i-numbers, generate path .ncheck(lM) 

names of known uucp systems, list.uucp(l) 

names, NIS+local names.nis_local_names(3N) 

names, print user and group.id(l) 

names: extract portions of path names.basename(l) 

namespace functions, NIS+.nis_names(3N) 

namespace: remove NIS+objects.nisrm(l) 

nan () - string-to-NaN conversion function .nan(3M) 

NaN, test for .isnan(3M) 

nanosleep() - high resolution sleep .nanosleep(2) 

napms () - suspend the call ing process .napms(3X) 

native language.glossary(9) 

NativeLanguagel/O (NLIO) Subsystem.nlio(5) 

NativeLanguageSupport (NLS).glossary(9) 

native languages, NLS information about .nl_langinfo(3C) 

natural logarithm function .loglp(3M) 

natural logarithm functions.log(3M) 

ncheck - generate path names from i-numbers.ncheck(lM) 

ncheck - generate pathnames from inode numbers for VxFS filesystem.ncheck_vxfs(lM) 

ncheckvxfs - generate pathnames from inode numbers for VxFS filesystem.ncheck_vxfs(lM) 

ncjerror () - get network configuration data base entry .getnetconfig(3N) 

nc_sperror () - get network configuration data base entry.getnetconfig(3N) 

ndd - network tuning.ndd(lM) 

ndir.h - format of FIP-UX directory streams.ndir(5) 

nearbyint () - round to nearest int function .rint(3M) 

neighboring systems description fileformat, ppp.ppp.Systems(4) 

neqn - format mathematical text for nroff.neqn(l) 

neqn, tbl, and nroff/troff constructs, remove .deroff(l) 

netconfig - network configuration database.netconfig(4) 

netdir() - generic transport name-to-address translation .netdir(3N) 

netdir f ree () - generic transport name-to-address translation .netdir(3N) 

netdir getbyaddr () - generic transport name-to-address translation .netdir(3N) 

netdir getbyname () - generic transport name-to-address translation .netdir(3N) 

netdir options () - generic transport name-to-address translation .netdir(3N) 

netdir_perror () - generic transport name-to-address translation .netdir(3N) 
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netdir_sperror () - generic transport name-to-address translation . 

netfmt - format tracing and logging binary files. 

netgroup: list of network groups . 

netname2host () - library routines for secure remote procedure calls. 

netname2user () - library routines for secure remote procedure calls. 

NETPATH component, get/etc/netconfig entry corresponding to. 

netrc - login information for rexec () and ftp . 

netstat - show network status. 

netti - control network tracing and logging . 

netticonf - configure tradng and logging commands. 

nettigen. conf - network tracing and logging configuration file. 

network and host byte order, convert values between . 

network connections, outgoing, list owners of . 

network entry, get or set . 

Network FileSystem (NFS) mount to remote filesystem, perform . 

network filesystem device files. 

Network FileSystem statistics. 

network group entry, get or set. 

network groups, list of . 

network host entry, get, set, or end . 

network I/O card access information . 

network information name service: new version . 

Network Information Service (NIS) binder processes. 

Network Information Service client interface. 

Network Information Servicedatabaseand directory structure. 

Network I nformation Service database, create or rebuild. 

Network Information Service databases, build and install . 

Network I nformation Service database, force propagation of a. 

Network Information Service domain name, set or display. 

Network I nformation Service map, print all values in a . 

Network Information Service map, print the values of selected keys in . 

Network I nformation Service passwd database, daemon for modifying. 

Network I nformation Service server, bind to a particular. 

Network Information Service, updateuser password in . 

Network I nformation Service: NIS map, query an NIS server for information about an 

Network Information System (NIS), change login password in . 

Network I nformation System database, make a . 

Network I nformation System server or map master, list which host is . 

network interface parameters, configure . 

network interfaces, initializeand connect all system FDDI . 

Network License Servers, verify working. 

network lock daemon . 

network name database. 

network packet routing, system support for local . 

network rwaii server. 

network station address string conversion routines. 

network status monitor. 

network status show. 

network status, show, FibreChannel Light Weight Protocol . 

network test packets, send. 

Network Time Protocol (NTP)daemon . 

Network Time Protocol (NTP), query program . 

Network Time Protocol (NTP), settimeand date. 

network tools, FDDI . 

network tracing and logging configuration file. 

network tracing and logging, control . 

network tuning. 

network tunnel driver, IP . 

network username server. 

network, connect to the FDDI . 

network, dump of file system across . 


Entry Name(Section) 

.netdir(3N) 

.netfmt(lM) 

.netgroup(4) 

.secure_rpc(3N) 

.secure_rpc(3N) 

.getnetpath(3N) 

.netrc(4) 

.netstat(l) 

.nettl(lM) 

.netti conf(lM) 

.netti gen. conf (4) 

.byteorder(3N) 

.owners(lM) 

.getnetent(3N) 

.vhe_u_mnt(lM) 

.nfs(7) 

.nfsstat(lM) 

.getnetgrent(3C) 

.netgroup(4) 

.gethostent(3N) 

.I an (7) 

.nis-Kl) 

.ypserv(lM) 

.ypclnt(3C) 

.ypfiles(4) 

.ypmake(lM) 

.ypinit(lM) 

.yppush(lM) 

.domainname(l) 

.ypcat(l) 

.ypmatch(l) 

.yppasswdd(lM) 

.ypset(lM) 

.yppasswd(3N) 

.yppoll(lM) 

.yppasswd(l) 

.makedbm(lM) 

.ypwhich(l) 

.ifconfig(lM) 

.fddisetup(lM) 

.i4tv(lM) 

.lockd(lM) 

.networks(4) 

.routing(7) 

.rwalld(lM) 

.net_aton(3C) 

.statd(lM) 

.netstat(l) 

.Iwpstat(lM) 

.ping(lM) 

.xntpd(lM) 

.ntpq(lM) 

.ntpdate(lM) 

.fddi(7) 

.netti gen .conf (4) 

.nettl(lM) 

.ndd(lM) 

.tun(4) 

.rusersd(lM) 

.fddiinit(lM) 

.vxdump(lM) 
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network, monitor uucp subnetwork activity .uusub(lM) 

network, remote backup over .dump(lM) 

network, restore file system incrementally across.restore(lM) 

network, scatter data to check the.spray(3N) 

network, write to all users over a .rwall(lM) 

networks - network name database.networks(4) 

net_aton() - network station address string conversion routines.net_aton(3C) 

net ntoa () - network station address string conversion routines.net_aton(3C) 

new commands, install .install(lM) 

new file system (generic), construct .newfs(lM) 

new file, create.creat(2) 

new HFS filesystem, construct a .newfs_hfs(lM) 

new key, creating in pubiickey database file.newkey(lM) 

new process, create a.fork(2) 

new version of the network information name service .nis-Kl) 

new VxFS file system, construct a.newfs_vxfs(lM) 

newaiias - install new elm aliases for user or system .newalias(l) 

newaiiases - rebuilds the database for the mail aliases file.newaliases(lM) 

newarray - configure a disk array.newarray(lM) 

newform - change or reformat a text file.newform(l) 

newfs - construct a new file system (generic) .newfs(lM) 

newfs - construct a new HFS filesystem .newfs_hfs(lM) 

newfs - construct new VxFS file system .newfs_vxfs(lM) 

newfs vxfs - construct new VxFS file system .newfs_vxfs(lM) 

newgrp - equivalent to exec newgrp . csh(l) 

newgrp - equivalent to exec newgrp . ksh(l) 

newgrp - equivalent to exec newgrp .sh-bourne(l) 

newgrp - equivalent to exec newgrp . sh-posix(l) 

newgrp - switch to a new group.newgrp(l) 

newkey - create a new key in thepubiickey database file.newkey(lM) 

newline character .glossary(9) 

newlinetranslation, enable/disable.nl(3X) 

newmaii - notify users of new mail in mailboxes.newmail(l) 

newpad() - pad management functions.newpad(3X) 

news - print news items.news(l) 

newterm() - screen initialisation functions.initscr(3X) 

newwin () - window creation functions .newwin(3X) 

next representablefloating-point value.nextafter(3M) 

nextafter (), nextafterf () - next representablefloating-point value.nextafter(3M) 

nextafterf (), nextafter () - next representable floating-poi nt value.nextafter(3M) 

nextkey () - get next key in database(old single-data-base version) .dbm(3X) 

NFS clients, directories to export to.exports(4) 

NFS clients, export and unexport directories to.exportfs(lM) 

NFS daemons.nfsd(lM) 

NFS file system disk blocks, report number of free .df_hfs(lM) 

NFS file system, determine which processes are using .fuser(lM) 

NFS filesystems, automatically mount.automount(lM) 

NFS filesystems, mount and unmount.mount_nfs(lM) 

NFS mount request server .mountd(lM) 

nfs - network filesystem device files .nfs(7) 

NFS statistics.nfsstat(lM) 

nfsd - NFS daemon .nfsd(lM) 

nfsstat - Network FileSystem statistics.nfsstat(lM) 

nftw () - walk a file tree executing a function .ftw(3C) 

nftw2 () - walk a file tree executing a function .ftw(3C) 

nftw64 () - file sysmmaptem API to support large files.fgetpos64(2) 

nice - alter command priority .csh(l) 

nice - run a command at nondefault priority .nice(l) 

nice value.renice(l) 

nice () - change priority of a process.nice(2) 

NIS (Network Information Service) binder processes.ypserv(lM) 
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NIS (Network Information System), change login password in .yppasswd(l) 

NIS database from NIS server to local node, transfer.ypxfr(lM) 

NIS domain name, set or display.domainname(l) 

NIS domain, get or set name of current .getdomainname(2) 

NIS information, changes.ypupdate(3C) 

NIS information, server for changing.ypupdated(lM) 

NIS map security file .securenets(4) 

NIS map, query an NIS server for information about an.yppoll(lM) 

NIS map, updates to .udpublickey(lM) 

NIS maps or/etc files: creating NIS+tables .nisaddent(lM) 

NIS server for information about an NIS map, query an.yppoll(lM) 

NIS server to local node, transfer NIS database from.ypxfr(lM) 

NIS updating, configuration filefor .updaters(lM) 

NlS+dient and server initialization utility .nisinit(lM) 

NIS+credentials, initialize for NIS+principals.nisclient(lM) 

NIS+credentials: creating.nisaddcred(lM) 

NIS+database access functions .nis_db(3N) 

NIS+databasefiles and directory structure.nisfiles(4) 

NIS+default values: display.nisdefaults(l) 

NIS+directories: creating .nismkdir(l) 

NIS+directories: list the contents.nisls(l) 

NIS+directories: removing.nisrmdir(l) 

NIS+directory object, update the public keys .nisupdkeys(lM) 

NIS+domain, initialize.nissetup(lM) 

NIS+domain, populate NIS+tables.nispopulate(lM) 

NIS+error messages, display .nis_error(3N) 

NIS+error messages: displaying.niserror(l) 

NIS+functions, misc .nis_servers(3N) 

NIS+group manipulation functions.nis_groups(3N) 

NIS+groups: administering .nisgrpadm(l) 

NIS+local names .nis_local_names(3N) 

NIS+log administration functions.nis_ping(3N) 

NIS+namespace functions.nis_names(3N) 

NIS+namespace: return the state using a conditional expression .nistest(l) 

nis+ - new version of the network information name service .nis+(l) 

NIS+object formats.nis_objects(3N) 

NIS+object, change owner .nischown(l) 

NIS+object: change access rights.nischmod(l) 

NIS+object: change the group owner .nischgrp(l) 

NIS+object: change the time to live value.nischttl(l) 

NIS+object: remove from the namespace.nisrm(l) 

NIS+object: symbolically link .nisln(l) 

NIS+password information: changing .nispasswd(l) 

nis+password table .ttsyncd(lM) 

NIS+password update daemon .rpc.nispasswdd(lM) 

NIS+principals, initializeNIS+credentialsfor.nisclient(lM) 

NIS+server statistics, report.nisstat(lM) 

NIS+servers, cache location information .nis cachemgr(lM) 

NIS+servers, send ping to.nisping(lM) 

NIS+servers, set up.nisserver(lM) 

NIS+service daemon .rpc.nisd(lM) 

NIS+subroutines.nis_subr(3N) 

NIS+tablefunctions.nis_tables(3N) 

NIS+tables and objects: displaying .niscat(l) 

NIS+tables in a NIS+domain, populate.nispopulate(lM) 

NIS+tables: administering.nistbladm(l) 

NIS+tables: creating from corresponding/etc files or NIS maps .nisaddent(lM) 

NIS+tables: utility for searching .nismatch(l) 

NIS+transaction log, display contents .nislog(lM) 

nis+trusted table.ttsyncd(lM) 

NIS+ utility to print out the contents of the shared cache file.nisshowcache(lM) 
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nisaddcred - create NIS+ credentials.nisaddcred(lM) 

nisaddent - create NIS+tables from corresponding /etc files or NIS maps .nisaddent(lM) 

niscat - display NIS+tables and objects .niscat(l) 

nischgrp - change the group owner of an NIS+object.nischgrp(l) 

nischmod - change access rights on an NIS+object .nischmod(l) 

nischown - change owner of an NIS+object .nischown(l) 

nischtti - change the time to live valueof an NIS+object .nischttl(l) 

nisclient - initialize NIS+ credentials for NIS+principals .nisclient(lM) 

nisd - NIS+service daemon .rpc.nisd(lM) 

nisdefauits - display NIS+ default values.nisdefaults(l) 

nisd_resoiv - NIS+servicedaemon .rpc.nisd(lM) 

niserror - display NIS+error messages.niserror(l) 

nisfiles - NIS+database files and directory structure.nisfiles(4) 

nisgrep - utility for searching NIS+tables.nismatch(l) 

nisgrpadm - administer NIS+groups.nisgrpadm(l) 

nisinit - NlS+dient and server initialization utility .nisinit(lM) 

nisin - symbolically link NIS+objects.nisln(l) 

nisiog - display the contents of the NIS+transaction log .nislog(lM) 

nisis - list the contents of an NIS+directory .nisls(l) 

nismatch - utility for searching NIS+tables.nismatch(l) 

nismkdir - create NIS+directories .nismkdir(l) 

nispasswd - change NIS+password information .nispasswd(l) 

nispasswdd () - NIS+ password update daemon .rpc.nispasswdd(lM) 

nisping - send ping to NIS+servers .nisping(lM) 

nispopuiate - populate the NIS+tables i n a NIS+domain .nispopulate(lM) 

nisrm - remove NIS+objects from the namespace.nisrm(l) 

nisrmdir - remove NIS+ directories.nisrmdir(l) 

nisserver - set up NIS+servers .nisserver(lM) 

nissetup - initializea NIS+domain .nissetup(lM) 

nisshowcache - NIS+util ity to print out the contents of the shared cache file.nisshowcache(lM) 

nisstat - report NIS+server statistics.nisstat(lM) 

nistbiadm - administer NIS+tables .nistbladm(l) 

nistest - return the state of the NIS+namespace using a conditional expression .nistest(l) 

nisupdkeys - update the public keys in a NIS+directory object .nisupdkeys(lM) 

nis add () - NIS+ namespace functions.nis_names(3N) 

nis addmember () - NIS+group manipulation functions .nis_groups(3N) 

nis add entry () - NIS+tablefunctions.nis_tables(3N) 

nis cachemgr - cache location information about NIS+servers .niscachemgr(lM) 

nis checkpoint () - NIS+log administration functions.nis_ping(3N) 

nis_cione_object () - NIS+subroutines.nis_subr(3N) 

nis creategroup () - NIS+ group mani pulation functions .nis_groups(3N) 

nis db () - NIS+databaseaccessfunctions .nis_db(3N) 

nis destroygroup () - NIS+group mani pulation functions .nis_groups(3N) 

nis destroy object () - NIS+subroutines.nis_subr(3N) 

nis_dir_cmp() - NIS+subroutines.nis_subr(3N) 

nis domain_of () - NIS+subroutines.nis_subr(3N) 

nis error () - display NIS+ error messages .nis_error(3N) 

nis first entry () - NI S+tablefunctions.nis_tables(3N) 

nis_freenames () - NIS +subroutines . niS_Subr(3N) 

nis freeresuit () - NIS+ namespace functions.nis_names(3N) 

nis freeservlist () - frees the I ist of NIS+servers.nis_server(3N) 

nis freetags () - frees the NI S+tags structure.nis_server(3N) 

nis getnames () - NIS+subroutines.nis_subr(3N) 

nis getservlist () - return a list of NIS+server structures.nis_server(3N) 

nis groups () - NIS+ group mani pulation functions .nis_groups(3N) 

nis„ismember () - NIS+ group mani pulation functions .nis_groups(3N) 

nis_leaf of () - NIS+subroutines.nis_subr(3N) 

nis terror () - display NIS+error messages .nis_error(3N) 

nis„list() - NIS+tablefunctions.nis_tables(3N) 

nis_local directory () - NIS+local names.nis_local_names(3N) 

nisjocal group() - NIS+local names.nis_local_names(3N) 
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nis jocal_host () -NIS+local names.nis_local_names(3N) 

ni.sj.ocal names () - NIS+local names.nis_local_names(3N) 

nisjocai_principai() - NIS+local names.nis_local_names(3N) 

nisjookupO - NIS+ namespace functions.nis_names(3N) 

nis map group () - NIS+ group manipulation functions .nis_groups(3N) 

nis mkdir () - create databases to support NIS+ services .nis_server(3N) 

nis modify () - NIS+ namespace functions.nis_names(3N) 

nis modify_entry () - NIS+table functions.nis_tables(3N) 

nis names () - NIS+ namespace functions.nis_names(3N) 

nis name of () - NIS+subroutines.nis_subr(3N) 

nis next entry () - NIS+table functions.nis_tables(3N) 

nis objects () - NIS+object formats.nis_objects(3N) 

nis_perror() - display NIS+error messages .nis_error(3N) 

nis_ping() - NIS+ log administration functions.nis_ping(3N) 

nis_print_group_entry () - NIS+group mani pulation functions .nis_groups(3N) 

nis_print_object () - NIS+subroutines.nis_subr(3N) 

nis remove () - NIS+ namespace functions.nis_names(3N) 

nis removemember () - NIS+group mani pulation functions .nis_groups(3N) 

nis remove entry () - NIS+table functions.nis_tables(3N) 

nis rmdir () - remove directory used to support NIS+services .nis_server(3N) 

nis server () - NIS+functions, misc.nis_server(3N) 

nis servstate () - set and read the various state variables of the NIS+ servers.nis_server(3N) 

nis sperrno () - display NIS+error messages .nis_error(3N) 

nis sperror () - display NIS+error messages .nis_error(3N) 

nis sperror_r () - display NIS+error messages .nis_error(3N) 

nis stats () - retrieve statistics about how the NIS+ server is operati ng .nis_server(3N) 

nis subr () - NIS+subroutines.nis_subr(3N) 

nis_tabies () - NIS+table functions.nis_tables(3N) 

nis verifygroup () - NIS+ group mani pulation functions .nis_groups(3N) 

ni - line numbering filter .nl(l) 

ni() - enable/disable newline translation .nl(3X) 

nlio - Native Language I/O (NLIO) Subsystem.nlio(5) 

NLIO Subsystem, Native Language I/O .nlio(5) 

niist - nlist structure format.nlist(4) 

nlist structure format.nlist(4) 

nlist () - get entries from name list .nlist(3C) 

niist64() - get entries from name list .nlist(3C) 

nljust - justify lines left or right for NLS printing .nljust(l) 

NLS (Native Language Support).glossary(9) 

NLS information, get locale-specific.locale(l) 

NLS message catalog, open or close for reading.catopen(3C) 

NLS, description of supported languages.Iang(5) 

NLS, get an NLS program message .catgets(3C) 

NLS, information about native languages.nl_langinfo(3C) 

NLS, language information constants.langinfo(5) 

NLS, open or close message catalog for reading.catopen(3C) 

NLS, query numeric formatting conventions of current locale.localeconv(3C) 

NLS: justify lines left or right for NLS printing .nljust(l) 

nlspath .glossary (9) 

ni langinf o () - obtain NLS string form of local language variable.nl_langinfo(3C) 

nm - print name list of common object file.nm(l) 

nocbreak () - input mode control functions .cbreak(3X) 

node from a binary search tree, delete a.tsearch(3C) 

node name.glossary(9) 

node name, display/set .uname(l) 

node name, get/set .uname(2) 

node, transfer NIS database from NIS server to local .ypxfr(lM) 

nodelay () - enable or disable block during read.nodelay(3X) 

nodes on FDDI ring, list characteristics of.fddinet(lM) 

noecho () - enable/disable terminal echo.echo(3X) 

nohup - ignore hangups during command execution.csh(l) 
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nohup - run a command immune to hangups. 

non-ASCI I characters in a file, make visibleor invisible. 

non-local goto, save/restore stack environment for. 

nondefault priority, run a command at . 

noni () - enable/disable newline translation . 

nonspacing characters . 

nop (do nothing) and return zero or non-zero exit status . 

noqif lush () - enabl^disable queue flushing. 

no raw () - i nput mode control functions. 

normalized value, floating-point test for . 

notify - notify user of change in job status. 

notify users of new mail in mailboxes. 

notify you when it is time to leave . 

notimeout () - control blocking on input . 

nroff, preprocess tables for . 

nrof f - format text . 

nroff input, eliminate .so'sfrom. 

nroff/troff files, check . 

nroff/troff, tbl, and neqn constructs, remove . 

nsiookup - query name servers interactively . 

nsquery () - query the Name Service Switch backend libraries 
nsswitch. conf - configuration filefor the name-service switch 
ntohi () - convert values between host and network byte order 
ntohs () - convert values between host and network byte order 

NTP (Network Time Protocol), set time and date. 

NTP daemon . 

NTP, query program. 

ntpdate - set timeand date via NTP. 

ntpq - Network Time Protocol query program. 

null - null file. 

nuiiadm - create empty file owned by adm with mode 664 . 

number of columns on terminal screen . 

number of free disk blocks, report (Berkeley version) . 

number of free DOS disk clusters, report . 

number of lines on terminal screen . 

number of processors installed in the system, determine. 

number to string or string array element, convert floating-point 

number to string, convert long doublefloating-point. 

number, convert string to double-precision . 

number, convert string to long double-precision. 

number, convert wide character string to double-precision. 

numbering filter, line . 

numbers, generate uniformly distributed pseudo-random . 

numbers, inode generation, install random . 

numbers, magic, for HP-UX implementations. 

numeric formatting conventions of current locale, query. 

object code debugger. 

object codefile, print symbol table (name list) for . 

object codefiles in a library, find optimum sequence for. 

object fileaccess library . 

object file, ELF, finish using. 

object file, link editor and assembler . 

object file, strip symbol and linenumber information from . 

object files and libraries, generate singleexecutablefilefrom .... 

object files in binary directories, install. 

object files, print section sizes and allocation space of. 

object files: dump information contained in. 

object formats, NIS+. 

object into virtual memory, map. 

object or binary file, find the printable strings in an. 

object, updatethe public keys in a NIS+directory object . 


Entry Name(Section) 

.nohup(l) 

.vis(l) 

.setjmp(3C) 

.nice(l) 

.nl(3X) 

.glossary (9) 

.true(l) 

.noqiflush(3X) 

.cbreak(3X) 

.isnormal(3M) 

. csh(l) 

.newmail(l) 

.leave(l) 

.notimeout(3X) 

.tbl(l) 

.nroff(l) 

.soelim(l) 

.checknr(l) 

.deroff(l) 

.nslookup(l) 

.nsquery(l) 

.nsswitch.conf(4) 

.byteorder(3N) 

.byteorder(3N) 

.ntpdate(lM) 

.xntpd(lM) 

.ntpq(lM) 

.ntpdate(lM) 

.ntpq(lM) 

.null(7) 

.acctsh(lM) 

.COLS(3X) 

.bdf(lM) 

.dosdf(l) 

.LI NE S(3X) 

pthread_processor_bind_np(3T) 

.ecvt(3C) 

.ldcvt(3C) 

.strtod(3C) 

.strtold(3C) 

.wcstod(3C) 

.nl(l) 

.drand48(3C) 

.fsirand(lM) 

.magic (4) 

.localeconv(3C) 

.adb(l) 

.nm(l) 

.lorder(l) 

.elf(3E) 

.elf_end(3E) 

.a.out(4) 

.strip(l) 

.Id(l) 

.cpset(lM) 

.size(l) 

.elfdump(l) 

.nis_objects(3N) 

.mmap(2) 

.strings(l) 

.nisupdkeys(lM) 
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object-codefile, execute.exec(2) 

objects, attributes, and storage formats for SD .sd(4) 

objects: symbolically link.nisln(l) 

obsolete library routines for RPC .rpc_soc(3N) 

obtain the thread ID for thecallingthread.pthread_self(3T) 

ocd - outbound connection daemon used by DDFA software.ocd(lM) 

ocdebug - outbound connection daemon debug utility used by DDFA software.ocdebug(lM) 

octal equivalents: ASCII character set .ascii(5) 

octal file dump.od(l) 

od - octal file dump.od(l) 

offset for an object file, get base .elf_getbase(3E) 

on - execute command on a remote host .on(l) 

on-line manuals, fix pages for faster viewing with man(l).fixman(lM) 

onintr - specify shell's treatment of interrupts.csh(l) 

open a directory and associated directory stream for access .directory(3C) 

open a message queue .mp_open(2) 

open a shared object .dlopen(3C) 

open crash dump for reading.cr_open(3) 

open file description.glossary(9) 

open file descriptor to a specific slot, duplicate an.dup2(2) 

open file descriptor, duplicate an .dup(2) 

open file.glossary(9) 

open files, file control options for.fcntl(5) 

open or close NLS message catalog for reading.catopen(3C) 

open or close pipe I/O to or from a process .popen(3S) 

open or re-open a stream file; convert file to stream.fopen(3S) 

Open Shortest Path First (OSPF).ospf monitor(lM) 

open() - open filefor reading or writing.open(2) 

open, access, or close a directory .directory(3C) 

open-file control .fcntl(2) 

open/create a named semaphore .sem_open(2) 

open64 () - file system API to support large files.creat64(2) 

opendir () - open a directory and associated directory stream for access .directory(3C) 

openiog () - initializesystem log file .syslog(3C) 

operating system information, display.uname(l) 

operating system information, get .uname(2) 

operating system name, display .uname(l) 

operati ng system name, get .uname(2) 

operating system, introduction .Introduction^) 

operating system, load (reboot) .boot(lM) 

operating system, save a crash dump of .savecrash(lM) 

operations on a stream file, get or reposition pointer for I/O .fseek(3S) 

operations, clock .clocks(2) 

operations, message control .msgctl(2) 

operations, real-time scheduling .rtsched(2) 

operations, semaphore control .semctl(2) 

operations, semaphore.semop(2) 

operations, set time limit for I/O .io_timeout_ctl(3l) 

operations, shared memory control .shmctl(2) 

operations, timer .timers(2) 

optargO , optind(), opterr () - get option letter from argument vector.getopt(3C) 

optimization - extract error messages from C source into a file.mkstr(l) 

optimize an existing H F S filesystem .tunefs(lM) 

optimum sequence for object codefiles in a library, find.lorder(l) 

option letter from argument vector, get.getopt(3C) 

options for a non-serial printer, set printing .slp(l) 

options for a terminal port, set .stty(l) 

options for transport endpoint (X/OPEN TLI-XTI).t_optmgmt(3) 

options on sockets, get or set .getsockopt(2) 

options, file control for open files.fcntl(5) 

options, parse command.getopt(l) 
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options, parse suboptions from a string .getsubopt(3C) 

options, parse utility (command) .getopts(l) 

opx25 - execute HALGOL programs .opx25(lM) 

order of data, convert string.strord(3C) 

orderable HP-UX manuals, list of.manuals(5) 

ordering relation for files in an object code library, find.lorder(l) 

ordinary file.glossary(9) 

ordinary file, make.mknod(2) 

organization, description of HP-UX header file.stdsyms(5) 

original, applying a diff file to.patch(l) 

orphan process .glossary(9) 

orphaned process group.glossary(9) 

osdd - print or check documents formatted with the mm macros .mm(l) 

OSPF gateways, monitor .ospf monitor(1M) 

ospf monitor - monitor OSPF gateways .ospfmonitor(lM) 

other scheduling policy.rtsched(2) 

out-bound terminal lineconnection, establish an .dial(3C) 

outbound connection daemon debug utility used by DDFA software .ocdebug(lM) 

outbound connection daemon used by DDFA software .ocd(lM) 

outgoing network connections, list owners of .owners(lM) 

output (format and print) files.pr(l) 

output attributes to terminal .vidattr(3X) 

output commands to the terminal.putp(3X) 

output cursor movement commands to the terminal .mvcur(3X) 

output device, finite-width, fold long lines for .fold(l) 

output first few lines in a file.head(l) 

output format, link editor and assembler .a.out(4) 

output of a varargs argument list, print formatted .vprintf(3S) 

output, formatted, print in window .mvprintw(3X) 

output, formatted, print to standard output, file, or string .printf(3S) 

output, standard, send copy of to specified file.tee(l) 

output, terminal, control functions .clearok(3X) 

output/input, buffered, standard stream file package .stdio(3S) 

over-temperature environment, handle.envd(lM) 

overflow monitor daemon, audit- .audomon(lM) 

overlapped windows, copy.overlay(3X) 

overlay () - copy overlapped windows .overlay(3X) 

overview of various system shells.sh(l) 

overwrite file with an existing file.cp(l) 

overwrite file with an existing file.mv(l) 

overwrite () - copy overlapped windows .overlay(3X) 

owner and group of a file, change .chown(2) 

owner and/or group, change in access control list (ACL).chownacl(3C) 

owner .glossary(9) 

owner of file, change.chown(l) 

owner, change owner of an NIS+object.nischown(l) 

owners - lists owners of outgoing network connections.owners(lM) 

ownership, summarize file system .quot(lM) 

ownership, summarize file system.quot_vxfs(lM) 

pack - compress (pack) files using Huffman code (see compact(l) .pack(l) 

packed decimal library, HP 3000-mode.hppac(3X) 

packet filter specification file format, ppp .ppp.Filter(4) 

Packet Mode modulefor STREAMS pty .pckt(7) 

packet routing, system support for local network.routing(7) 

packets, echo .ping(lM) 

packets, ECHOREQUEST.ping(lM) 

packets, spray.spray(lM) 

pad management functions.newpad(3X) 

pad, enhanced, management function .subpad(3X) 

pad, refresh immediately after writing a character rendition.pechochar(3X) 

page - file perusal filter for crt viewing.more(l) 
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page number, physical, validate whether dumped .cr_isaddr(3) 

page size, get the current.getpagesize(2) 

page, print out a manual; find manual information by keywords .man(l) 

paging behavior, advise system of process's expected .madvise(2) 

paging space information, system .swapinfo(lM) 

paging, add swap device for interleaved.swapon(2) 

paging, enabledeviceor filesystem.swapon(lM) 

pair_content () - color manipulation functions.can_change_color(3X) 

PAM account validation procedures, perform .pam_acct_mgmt(3) 

pam- PluggableAuthentication Module.pam(3) 

PAM routine to retrieve user name.pam_get_user(3) 

PAM routines to maintain module specific state .pam_set_data(3) 

PAM .see PluggableAuthentication Modules 

PAM Service Module APIs .pam_sm(3) 

PAM session creation and termination operations, perform.pam_open_session(3) 

PAM user policy definition service module .pam_updbe(5) 

PAM, authentication information routines for PAM .pam_set_item(3) 

PAM, authentication transaction routines for PAM .pam_start(3) 

PAM, get error message string .pam_strerror(3) 

PAM, perform authentication within the PAM framework .pam_authenticate(3) 

PAM, perform password related functions withinthePAM framework .pam_chauthtok(3) 

PAM, service provider implementation for pam_acct_mgmt.pam_sm_acct_mgmt(3) 

PAM, service provider implementation for pam_authenticate () .pam_sm_authenticate(3) 

PAM, service provider implementation for pam_chauthtok () .pam_sm_chauthtok(3) 

PAM, service provider implementation for pam open session () and pam ciose„session () 

.pam_sm_open_session(3) 

PAM, service provider implementation for pam_setcred() .pam_sm_setcred(3) 

PAM, user configuration files for pluggableauthentication modules.pam_user.conf(4) 

pam.conf - configuration filefor pluggableauthentication module.pam.conf(4) 

pam acct mgmt () - perform PAM account validation procedures .pam_acct_mgmt(3) 

pam authenticate () - perform authentication withinthePAM framework.pam_authenticate(3) 

pam chauthtok () - perform password related functions within the PAM framework.pam_chauthtok(3) 

pam ciose session () - perform PAM session creation and termination operations.pam_open_session(3) 

pam end () - authentication transaction routines for PAM .pam_start(3) 

pam get data () - PAM routines to maintain module specific state.pam_set_data(3) 

pam get_item () - authentication information routines for PAM .pam_set_item(3) 

pam get_user () - PAM routine to retrieve user name.pam_get_user(3) 

pam open session () - perform PAM session creation and termination operations.pam_open_session(3) 

pam setcred () - modify and delete user credentials for an authentication service.pam_setcred(3) 

pam set data () - PAM routines to maintain module specific state.pam_set_data(3) 

pam set_item () - authentication information routines for PAM .pam_set_item(3) 

pam sm() - PAM Service Module APIs .pam_sm(3) 

pam sm acct mgmt () - Service provider implementation for pam_acct_mgmt.pam_sm_acct_mgmt(3) 

pam sm authenticate () - service provider implementation for pam authenticate () 

.pam_sm_authenticate(3) 

pam sm chauthtok () - service provider implementation for pam_chauthtok () .pam_sm_chauthtok(3) 

pam sm close_session () - service provider implementation for pam close .session () 

.pam_sm_open_session(3) 

pam sm open session () - service provider implementation for pam open session () 

.pam_sm_open_session(3) 

pam sm setcred() - service provider implementation for pam_setcred() .pam_sm_setcred(3) 

pam start () - authentication transaction routines for PAM .pam_start(3) 

pam strerror () - get PAM error message string.pam_strerror(3) 

pam unix - authentication, account, session and password management PAM modules for UNIX .. pam_unix(5) 

pam updbe - user policy definition service module, PAM .pam_updbe(5) 

pam user. conf - user configuration filefor pluggableauthentication modules.pam_user.conf(4) 

parallel poll on HP-IB, control response to .hpib_card_ppoll_resp(3l) 

parallel poll valueoccurs, wait until a particular .hpib_wait_on_ppoll(3l) 

parameter, system, query, set, or reset .kmtune(lM) 

parameters, configure network interface .ifconfig(lM) 

parameters, display system .sysdef(lM) 
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parent directory .glossary(9) 

parent process .fork(2) 

parent process .glossary(9) 

parent process ID .glossary(9) 

parent process ID, get.getpid(2) 

parents, synchronisea window with .syncok(3X) 

parity consistency of HP SCSI disk array LUNs .pscan(lM) 

parity information, repair disk array LUN .rpr(lM) 

parity information, scan for consistency.scn(lM) 

parse command options.getopt(l) 

parse suboptions from a string .getsubopt(3C) 

parse utility (command) options .getopts(l) 

parser used by DDFA software, dedicated ports.dpp(lM) 

particular Network I nformation Service server, bind to a.ypset(lM) 

particular parallel poll valueoccurs, wait until a .hpib_wait_on_ppoll(3l) 

partition DDS tape cartridge.mediainit(l) 

partitions to LVM logical volumes, prepare root file system for migration from .Ivmmigrate(lM) 

Pascal and C execution startup routines.crt0(3) 

pass-through device driver, SCSI .scsi_ctl(7) 

pass-through device driver, SCSI .scsi_pt(7) 

passwd - change login password and associated attributes.passwd(l) 

passwd database, daemon for modifying Network Information Service.yppasswdd(lM) 

passwd file.login(l) 

passwd file, change default login shell .chsh(l) 

passwd - password file, <pwd.h> format.passwd(4) 

password and group hashing and cashing daemon .pwgrd(lM) 

password database entry, manipulate protected.getprpwent(3) 

password encryption function .crypt(3C) 

password expiration .passwd(l) 

password file entry, write.putpwent(3C) 

password file, <pwd.h> format.passwd(4) 

password file, check.pwck(lM) 

password file, edit using vi editor .vipw(lM) 

password file, get entry from.getpwent(3C) 

password file, grp.h for user group access and identification .group(4) 

password file, information used by finger, change.chfn(l) 

password file, protected password database.prpwd(4) 

password generation .passwd(l) 

password .glossary(9) 

password in Network Information Service, update user .yppasswd(3N) 

password in Network Information System (NIS), change login .yppasswd(l) 

password information, get (pwget) .pwget(l) 

password related functions within the PAM framework, perform .pam_chauthtok(3) 

password update daemon, NIS+.rpc.nispasswdd(lM) 

password, authentication, account, and session management PAM modules for UNIX .pam_unix(5) 

password, change login .passwd(l) 

password, read from terminal while suppressing echo .getpass(3C) 

password: changing NIS+information .nispasswd(l) 

passwrod and group hashing and caching statistics .pwgr_stat(lM) 

paste - merge corresponding lines of several files or subsequent lines of one file .paste(l) 

patch - program for applying a diff file to an original .patch(l) 

patch up damaged file system (generic) .fsdb(lM) 

patch up damaged HFS filesystem .fsdb_hfs(lM) 

path and route between hosts, compute shortest.pathalias(l) 

path environment variable.login(l) 

path name component .basename(3C) 

path name corresponding to i-number, list .ff_hfs(lM) 

path name.glossary(9) 

path name of parent directory.basename(3C) 

path name resolution.glossary(9) 

path name variables, get configurable.pathconf(2) 
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path names from i-numbers, generate.ncheck(lM) 

path names, check .pathchk(l) 

path names, extract portions of .basename(l) 

path prefix.glossary(9) 

path, map device ID to file .devnm(3) 

path-name of current working directory, get .getcwd(3C) 

path: create, remove directories in a path .mkdirp(3G) 

pathalias database, access and manage the .uupath(l) 

pathaiias - electronic address router .pathalias(l) 

pathchk - check path names.pathchk(l) 

pathconf () - get configurable path name variables.pathconf(2) 

pathfind() - search for named file in named directories .pathfind(3G) 

pathname of current working directory, get.getwd(3C) 

pathname, resolve .realpath(3X) 

pathnames from inode numbers for VxFS filesystem, generate.ncheck_vxfs(lM) 

paths and aliases, locate a program file including.which(l) 

pattern matching and regular expression notation definitions.regexp(5) 

pattern scanning and processing language, text .awk(l) 

patterns, match filename.fnmatch(3C) 

pause execution for a time interval .sleep(l) 

pause () - suspend process until signal .pause(2) 

pauses jobs, physical printers, servers, or queues.pdpause(l) 

pax - portable archive exchange .pax(l) 

PC-NFS authentication and print request server .pcnfsd(lM) 

peat - expand (unpack) and cat Huffman coded file (seecompact(l) .pack(l) 

pcf -port configuration file, used by DDFA software.pcf(4) 

pekt - Packet Modemodulefor STREAMS pty .pckt(7) 

pciose () - terminate pipe I/O to or from a process.popen(3S) 

penfsd - PC-NFS authentication and print request server .pcnfsd(lM) 

pcserver - BasicSerial and HP AdvanceLink server .pcserver(lM) 

pdc - processor-dependent code (firmware).pdc(lM) 

pdclean - removes all jobs from the specified object .pdclean(l) 

pdcreate - creates print objects .pdcreate(l) 

pddeesetup - configure DCE for the HP Distributed Print Service.pddcesetup(lM) 

pddeiete - deletes print objects.pddeletefl) 

pddisable - stops printers from accepting jobs and logs from logging.pddisable(l) 

pdenabie - enables printers to accept jobs and logs to log .pdenable(l) 

pdf - Product Description Fileformat .pdf(4) 

PDF, create from an input.mkpdf(lM) 

pdfdiff - compare two Product Description Files .pdfdiff(lM) 

pdfdiff - differences between two Product Description Files.pdfdiff(lM) 

pdfdiff - Product Description Files, compare two .pdfdiff(lM) 

pdgwcfg - displays thetext and description of a HPDPS message at thecommand line.pdgwcfg(l) 

pdgwcfg.conf - configuration filefor HPDPS gateway printers.pdgwcfg.conf(4) 

pdis - lists selected attribute values.pdclean(l) 

pdmod - modifies attributes of submitted print jobs.pdmod(l) 

pdmsg - displays thetext and description of a HPDPS message at thecommand line.pdmsg(l) 

pdpii - is processor a pdpll?.machid(l) 

pdpause - pausesjobs, physical printers, servers, or queues.pdpause(l) 

pdpr - submits print jobs.pdpr(l) 

pdpromote - advances a job to the top of a queue.pdpromote(l) 

pdq - queries and lists the status of one or more print jobs.pdq(l) 

pdresubmit - resubmits previously submitted print jobs .pdresubmit(l) 

pdresume - enables paused objects to resume operation .pdresume(l) 

pdrm - removes print jobs.pdrm(l) 

pdset - modifies attributes of submitted print jobs .pdset(l) 

pdshutdown - stop servers.pdshutdown(l) 

pdstartclient - start the HPDPS client daemon .pdstartclient(lM) 

pdstartspl - create or restart an HPDPS spooler .pdstartspl(lM) 

pdstartsuv- create or restart an HPDPS supervisor .pdstartsuv(lM) 

pdstopd - stop the HPDPS client daemon.pdstopd(lM) 
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pd_att - index of attributemanpages for HP Distributed Print Service.pd_att(5) 

pd_att_document - list of attributesfor a document object 

(HP Distributed Print Service) .pd_att_document(5) 

pd_att_ivdocument - list of attri butes for an initial value document object 

(HP Distributed Print Service) .pd_att_ivdocument(5) 

pd_att_ivjob - list of attributesfor an initial valuejob object (HP Distributed Print Service) .pd_att_ivjob(5) 

pd_attj°b - list of attributesfor a job object (HP Distributed Print Services).pd_attjob(5) 

pd_att_log - list of attributesfor a log object (HP Distributed Print Service).pd_att_log(5) 

pd_att_log_ptr - list of attributesfor a logical printer object 

(HP Distributed Print Services).pd_att_log_ptr(5) 

pd_att_phy_ptr - list of attributesfor a physical printer object 

(HP Distributed Print Service).pd_att_phy_ptr(5) 

pd_att_queue- list of attributesfor a queue object (HP Distributed Print Service).pd_att_queue(5) 

pd_att_sp oo l er - list of attributesfor a spooler object (HP Distributed Print Service) .pd_att_spooler(5) 

pd_att_supervisor - list of attributesfor a supervisor object 

(HP Distributed Print Service).pd_att_supervisor(5) 

pechochar () - writea character rendition and immediately refresh the pad .pechochar(3X) 

pecho wchar () - writea character rendition and immediately refresh the pad .pechochar(3X) 

peer, get address of connected .getpeername(2) 

pending cancellation requests, process any .pthread_testcancel(3T) 

pending signals, examine.sigpending(2) 

per-process accountingfileformat.acct(4) 

per-process ti mer, allocate a.mktimer(3C) 

per-process timer, free a .rmtimer(3C) 

per-process ti mer, get valueof a.gettimer(3C) 

per-process ti mer, relatively arm a .reltimer(3C) 

per-session accounting records, convert login/logoff records to.acctcon(lM) 

per-session records, convert to total accounting records.acctcon(lM) 

perform authentication within the PAM framework.pam_authenticate(3) 

perform Cyclical Redundancy Check on a file.sum(l) 

perform I/O on kernel memory based on symbol name.kmem(7) 

perform I/O with an HP-IB channel from buffers.hpib_io(3l) 

perform NFS mount to remote filesystem.vhe_u_mnt(lM) 

perform PAM account validation procedures .pam_acct_mgmt(3) 

perform PAM session creation and termination operations.pam_open_session(3) 

perform password related functions withinthePAM framework .pam_chauthtok(3) 

perform word expansions.wordexp(3C) 

performanceanalysisinformation, print LP spooler.Ipana(lM) 

performance data from remote kernel, get.rstat(3N) 

periodic accounting summary files, create.acctsh(lM) 

permission bits .glossary(9) 

permissionsfile, check theuucp directories and .uucheck(lM) 

permissions mask for file creation, set and get .umask(2) 

permissions mode mask for file-creation, set access.umask(l) 

permissions, change file mode access.chmod(l) 

permissions, change file mode access.chmod(2) 

permit or deny write(l) messages from other users to terminal .mesg(l) 

permuted index, generate .ptx(l) 

perror (), errno (), sys erriist (), sys nerr () - system error messages.perror(3C) 

perusefileon CRT terminals.more(l) 

perusefileon soft-copy terminals.pg(l) 

pfmt () - display message in standard format .pfmt(3C) 

pfmt () - message, display in standard format .pfmt(3C) 

pfmt () - standard format, display message in .pfmt(3C) 

PFS clients, directories to export to .pfs_exports(5) 

PFS clients, export and unexport directories to .pfs_exportfs(lM) 

PFS daemon.pfsd(lM) 

PFS mount request server.pfsmountd(lM) 

pfs - PFS, portable file system.pfs(4) 

PFS, porta bl e fi I e system.pfs(4) 

pfsd - PFS daemon.pfsd(lM) 
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pfs exportfs - export and unexport directories to PFS clients.pfs_exportfs(lM) 

pfs exports - directories to export to PFS clients .pfs_exports(5) 

pf s_f stab - static file system mounting table.pfs_fstab(5) 

pfs mount - mount and unmount CD-ROM filesystems.pfs mount(lM) 

pfs mountd - PFS mount request server.pfsmountd(lM) 

pg - file perusal filter for soft-copy terminals .pg(l) 

phone message transcription system .answer(l) 

physical device description fileformat, for ppp.ppp.Devices(4) 

physical environment daemon, system .envd(lM) 

physical extents allocated to LVM logical volume, decrease .Ivreduce(lM) 

physical extents, move from one LVM physical volume to other physical volumes .pvmove(lM) 

physical memory address mapping.iomap(7) 

physical page number, validate whether dumped .cr_isaddr(3) 

physical volume (LVM) to other physical volumes, move allocated physical extents from.pvmove(lM) 

physical volume for usein LVM volume group, create .pvcreate(lM) 

physical volume group information file(LVM) .Ivmpvg(4) 

physical volume in LVM volume group, change characteristics and access path .pvchange(lM) 

physical volume in LVM volume group, check or repair a .pvck(lM) 

physical volume.Ivm(7) 

physical volumes in LVM volume group, display information about.pvdisplay(lM) 

physical volumes, extend an LVM volume group by adding.vgextend(lM) 

physical volumes, reduce LVM volume group by removing.vgreduce(lM) 

physical volumes, scan for LVM volume groups .vgscan(lM) 

PIC.glossary (9) 

ping - send echo packets to a network host .ping(lM) 

ping, send to NIS+servers.nisping(lM) 

pipe fitting.tee(l) 

pipe.glossary(9) 

pipe I/O to or from a process, open or close.popen(3S) 

pipe () - create an interprocess channel.pipe(2) 

pipe: STREAMS-based pipe.isastream(3C) 

pipes, create named.mknod(lM) 

play audiofile.send sound(l) 

piock () - lock process, text, data, stack, or shared library in memory .plock(2) 

piotdvr - plotter driver for Ip.Ipfilter(l) 

plotter .see printer 

pluggableauthentication module.pam(3) 

pluggableauthentication module, configuration file.pam.conf(4) 

PluggableAuthentication Modules .login(l) 

pmap getmaps () - obsolete library routines for RPC .rpc_soc(3N) 

pmap getport () - obsolete library routines for RPC .rpc_soc(3N) 

pmap rmtcaii () - obsolete library routines for RPC .rpc_soc(3N) 

pmap set () - obsolete library routines for RPC .rpc_soc(3N) 

pmap unset () - obsolete library routines for RPC .rpc_soc(3N) 

pnoutrefresh () - pad management functions.newpad(3X) 

point to point protocol authentication fileformat .ppp.Auth(4) 

point to point protocol daemon.cp(l) 

point to point protocol physical device description fileformat.ppp.Devices(4) 

pointer array, sort a directory .scandir(3C) 

pointer for binary search tree, get data .tsearch(3C) 

pointer for I/O operations on a stream file, get or reposition .fseek(3S) 

pointer, file, move read/write.Iseek(2) 

pointer, stream, map to file descriptor .fileno(3S) 

pointer, string, for ELF files, make.elf_strptr(3E) 

poll on HP-lB bus, conduct a serial .hpib_spoll(3l) 

poll on H P-l B, control response to parallel .hpib_card_ppoll_resp(3l) 

poll valueoccurs, wait until a particular parallel .hpib_wait_on_ppoll(3l) 

polio - monitor I/O conditions on multi pie file descriptors .poi I (2) 

pong - send FibreChannel Light Weight Protocol Echo Request packet .pong(lM) 

popd - pop directory stack.csh(l) 

popen() - initiate pipe I/O to or from a process.popen(3S) 
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populate the NIS+tables in a NIS+domain .nispopulate(lM) 

port number, RPC, get .getrpcport(3N) 

port socket, return a reserved .rcmd(3N) 

port, IP, bind socket to a privileged .bindresvport(3N) 

portable archive exchange .pax(l) 

portable archives, library and archive maintainer for .ar(l) 

portablefile name character set.glossary(9) 

portable file system, PFS .pfs(4) 

portal - header file for future applications.portal(5) 

portions of path names, extract .basename(l) 

ports file used by DDFA software and Telnet port identification feature, dedicated.dp(4) 

ports parser used by DDFA software, dedicated .dpp(lM) 

position-independent code (PIC) .glossary(9) 

positive difference function .fdim(3M) 

POSIX asynchronous I/O .aio(5) 

POSIX configuration values, get.getconf(l) 

POSIX real-time priority, execute process with.rtsched(l) 

POSIX realtime extensions.aio(5) 

POSIX realtime extensions .aio_cancel(2) 

POSIX realtime extensions.aio_error(2) 

POSIX realtime extensions .aio_fsync(2) 

POSIX realtime extensions .aio_read(2) 

POSIX realtime extensions.aio_return(2) 

POSIX realtime extensions.aio_suspend(2) 

POSIX realtime extensions.aio_write(2) 

POSIX real time extensions .liolisti o{2) 

POSIX real time extensions.mlock(2) 

POSIX real time extensions .mlockall(2) 

POSIX real time extensions.munlock(2) 

POSIX real time extensions.munlockall(2) 

POSIX semaphore, closea named semaphore.sem_close(2) 

POSIX semaphore, destroy an unnamed semaphore.sem_destroy(2) 

POSIX semaphore, initializean unnamed semaphore.sem_init(2) 

POSIX semaphore, lock a semaphore.sem_wait(2) 

POSIX semaphore, lock a semaphore without blocking.sem_wait(2) 

POSIX semaphore, open/create a named semaphore.sem_open(2) 

POSIX semaphore, read .sem_getvalue(2) 

POSIX semaphore, unlink a named semaphore.sem_unlink(2) 

POSIX semaphore, unlock a semaphore.sem_post(2) 

POSIX.lcthreads .pthread(3T) 

posters, make in large letters.banner(l) 

pow(), powf () - power function .pow(3M) 

power functions. pow(3M) 

power_onoff - timed, automatic system power on, and power off .power_onoff(lM) 

powf (), pow () - power function (float version) .pow(3M) 

ppp authentication fileformat.ppp.Auth(4) 

ppp dialer description fileformat .ppp.Dialers(4) 

ppp encryption keys fileformat.ppp.Keys(4) 

ppp neighboring systems description fileformat.ppp.Systems(4) 

ppp packet filter specification fileformat .ppp.Filter(4) 

ppp physical device description fileformat .ppp.Devices(4) 

ppp. auth - ppp authentication fileformat .ppp.Auth(4) 

ppp.Devices - ppp physical device description fileformat .ppp.Devices(4) 

ppp.Dialers - ppp dialer descri ption file format .ppp.Dialers(4) 

ppp.Filter - ppp packet filter specification fileformat .ppp.Filter(4) 

ppp.Keys - ppp encryption keys fileformat.ppp.Keys(4) 

PPP. Systems - ppp neighboring systems description fileformat.ppp.Systems(4) 

pppd - point to point protocol daemon .pppd(l) 

pr - format and print files.pr(l) 

praiiases - print system-widesendmaiI aliases.praliases(l) 

prcmd - return streams to parallel remote commands.prcmd(3N) 
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prctmp - print session record file created by acctconi .acctsh(lM) 

prdaily - print daily accounting report .acctsh(lM) 

prealloc - preallocate disk storage.prealloc(l) 

prealloc () - preallocate fast disk storage .prealloc(2) 

preaiioc64 () - file sysmmaptem API to support large files .creat64(2) 

preallocate fast disk storage.prealioc(2) 

preallocate space for a disk storage file.prealloc(l) 

Precision Architecture assembler .as(l) 

prefix characters to obtain text line of specified length .newform(l) 

prefresh () - pad management functions.newpad(3X) 

prepare an incomplete executable for faster program start-up.fastbind(l) 

prepare execution profile.monitor(3C) 

prepare LVM logical volume to be root, swap, or dump volume.Ivlnboot(lM) 

prepare root file system for migration from partitions to LVM logical volumes .Ivmmigrate(lM) 

preprocess mathematical text for nroff.neqn(l) 

preprocess tables for nroff .tbl(l) 

preprocessor lines, remove .unifdef(l) 

preprocessor, C language.cpp(l) 

preset contents of memory area to specified byte.memory(3C) 

prevent terminal use by others .lock(l) 

previous get of an SCCS file, undo a .unget(l) 

primary swap volume, prepare LVM logical volume to be.Ivlnboot(lM) 

primary swap volume, remove LVM logical volume link .Ivrmboot(lM) 

primes, factor - factor a number, generate large primes.factor(l) 

primitive system data types.types(5) 

principals, NIS+, initializeNIS+credentialsfor.nisclient(lM) 

print (echo) arguments.echo(l) 

print a libcrash error or warming message.cr_perror(3) 

print all values in a Network Information Service map .ypcat(l) 

print and summarize an SCCS file .prs(l) 

print any total accounting (tacct) file.acctsh(lM) 

print calendar.cal(l) 

print checksum and block count of a file .sum(l) 

print checksum and block count of a file .sum(l) 

print current SCCS file editing activity.sact(l) 

print current system-dock date and time .date(l) 

print files, format and .pr(l) 

print first few lines in a file .head(l) 

print formatted arguments.printf(l) 

print formatted output in a window.vwprintw(3X) 

print formatted output in a window .vw_printw(3X) 

print formatted output in window .mvprintw(3X) 

print formatted output of a varargs argument list .vprintf(3S) 

print formatted output to standard output, file, or string .printf(3S) 

print information about local LicensePower/iFOR target id.i4target(lM) 

print list of current system users.who(l) 

print log messages and other information about RCS files.rlog(l) 

print LP request status information .Ipstat(l) 

print LP spooler performanceanalysisinformation .Ipana(lM) 

print mail traffic statistics.mailstats(l) 

print namelist of object codefile.nm(l) 

print name of current PIP-UX model.model (1) 

print news items.news(l) 

print or check documents formatted with themm macros .mm(l) 

print or display effective current user id.whoami(l) 

print out a manual entry; find manual information by keywords .man(l) 

print out mail in the incoming mailbox file.prmail(l) 

print out or compare terminfo descriptions.infocmp(lM) 

print out the contents of the shared cache file, NIS+ .nisshowcache(lM) 

print out the environment .printenv(l) 

print - output from shell .ksh(l) 
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print - output from shell . 

print process accounting files. 

print request server, PC-NFS. 

print requests on an LP printer . 

print section sizes and allocation space of object files. 

print session record file created by acctconi. 

print symbol table for object codefile. 

print system-widesendmail aliases. 

print the values of selected keys in Network Information Service map 

print user and group IDs and names . 

print working directory name. 

print, copy, and concatenate files. 

printablerepresentation of a character, generate . 

printablerepresentation of a wide character, generate . 

printable strings in an object or other binary file, find the. 

printenv - print out theenvironment . 

printer capability database. 

printer daemon for LP requests from remote systems. 

printer device files, line. 

printer for use with tsm, add or remove a. 

pri nter spool ing system. 

printer, LP, allow or prevent queuing requests. 

printer, LP, print/alter/cancel requests. 

printer, set printing options for a non-serial . 

printers, LP, enable/disable. 

printf - print formatted arguments. 

printf () - print formatted output to standard output . 

printing options for a non-serial printer, set . 

prints the mail queue. 

printstat - check status of serial printer. 

printw() - pri nt formatted output i n wi ndow . 

prioceiling attribute, get or set. 

priority of a process, change . 

priority of running processes, alter . 

priority . 

priority, get or set process. 

priority, POSIX real-time, execute process with. 

priority, real-time, execute process with. 

priority, run a command at nondefault . 

private encryption key storage, server for . 

privgrp - format of privileged values . 

privgrp, get special attributesfor group . 

privilege group, get or set special attributes. 

privileged groups. 

privileged IP port, bind socket to a . 

privileged values, format of . 

privileges for group, list access. 

privileges, associate group with certain . 

pri_hpux_to_posix () - return POSIX process priority . 

pri„posix_to_hpux() - return PIP-UX process priority. 

PRM . 

prmaii - print out mail in the incoming mail box file. 

process 1 . 

process 16-bit characters, tools to . 

process accounting files, search and print . 

process accounting. 

process accounting, daily accounting shell procedure. 

process accounting, enableor disable. 

process and child process times, get. 

process any pending cancellation requests. 

process C language include and conditional instructions. 


Entry Name(Section) 

.sh-posix(l) 

.acctcom(lM) 

.pcnfsd(lM) 

. Ip(l) 

.size(l) 

.acctsh(lM) 

.nm(l) 

.praliases(l) 

.ypmatch(l) 

.id(l) 

.pwd(l) 

.cat(l) 

.unctrl(3X) 

.wunctrl(3X) 

.strings(l) 

.printenv(l) 

.terminfo(4) 

.rlpdaemon(lM) 

. Ip(7) 

.tsm.lpadmin(lM) 

.see L P 

.accept(lM) 

. Ip(l) 

.slp(l) 

.enable(l) 

.printf(l) 

.printf(3S) 

.slp(l) 

.mailq(l) 

.I pfilter (1) 

.mvprintw(3X) 

pthread_mutexattr_getprotocol(3T) 

.nice(2) 

.renice(l) 

.renice(l) 

.getpriority(2) 

.rtsched(l) 

.rtprio(l) 

.nice(l) 

.keyserv(l) 

.privgrp(4) 

.getprivgrp(l) 

.getprivgrp(2) 

.glossary (9) 

.bindresvport(3N) 

.privgrp(4) 

.getprivgrp(l) 

.setpri vgrp(lM) 

.rtsched(2) 

.rtsched(2) 

.see Process Resource Manager 

.prmail(l) 

.glossary (9) 

.nl_tools_16(3X) 

.acctcom(lM) 

.see accounting 

.runacct(lM) 

.acct(2) 

.times(2) 

.pthread_testcancel(3T) 

.cpp(l) 
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process environment, clear the. 

process . 

process group . 

process group ID for job control, set . 

process group ID . 

process group ID, create session and set . 

process group ID, foreground, get. 

process group ID, foreground, set . 

process group ID, get . 

process group ID, set . 

process group leader. 

process group lifetime. 

process ID . 

process ID, get . 

process interval timer, set or get value of . 

process lifetime . 

process mail through screen-oriented interface. 

process or group of processes, send signal . 

process priority, get or set. 

Process Resource Manager . 

Process Resource Manager. 

Process Resource Manager . 

Process Resource Manager . 

Process Resource Manager. 

process status, report. 

process to stop or terminate, wait for child. 

process trace. 

process's alarm clock, set . 

process's expected paging behavior, advise system of. 

process, calling, set or clear auditing on. 

process, change priority of a . 

process, child, wait to change state. 

process, child, wait to change state. 

process, create a new. 

process, execute, with POSIX real-time priority. 

process, execute, with real-time priority. 

process, force target to run serially with other processes. 

process, force target to run serially with other processes . 

process, get audit ID (aid()) for current. 

process, get audit process flag for calling. 

process, lock address space in memory. 

process, lock in memory . 

process, lock into memory after allocating data and stack space 

process, lock segment in memory . 

process, open or cl ose pi pe I /O to or from a . 

process, queue a signal to a . 

process, self-auditing, write audit record for . 

process, send signal to. 

process, set audit ID (aid ()) for current . 

process, spawn new (use fork () instead). 

process, suspend or resume auditing on current. 

process, suspend the calling process. 

process, suspend until signal. 

process, terminate. 

process, terminate. 

process, unlock memory segment . 

process, unlock virtual address space . 

process-shared attribute, get or set . 

process-shared attribute, get or set. 

process-shared attribute, get or set . 

processes and users, list current . 


Entry Name(Section) 

.clearenv(3C) 

.glossary (9) 

. glossary(9) 

.setpgid(2) 

.glossary (9) 

.setsid(2) 

.tcgetpgrp(3C) 

.tcsetpgrp(3C) 

.getpid(2) 

.setpgrp(2) 

.glossary (9) 

.glossary (9) 

.glossary (9) 

.getpid(2) 

.getitimer(2) 

.glossary (9) 

.elm(l) 

.kill (2) 

.getpriority(2) 

.acctcom(lM) 

.cron(lM) 

.exec(2) 

.login(l) 

.ps(l) 

. ps(l) 

.wait(2) 

.ptrace(2) 

.alarm(2) 

.madvise(2) 

.setaudproc(2) 

.nice(2) 

.wait3(2) 

.waitid(2) 

.fork(2) 

.rtsched(l) 

.rtprio(l) 

.serialized) 

.serialize(l) 

.getaudid(2) 

.getaudproc(2) 

.mlockall(2) 

.plock(2) 

.datalock(3C) 

.mlock(2) 

.popen(3S) 

.sigqueue(2) 

.audwrite(2) 

.kill(l) 

.setaudid(2) 

.vfork(2) 

.audswitch(2) 

.napms(3X) 

.pause(2) 

. exit(2) 

.kill(l) 

.munlock(2) 

.munlockall(2) 

... pthread_condattr_getpshared(3T) 
pthread_mutexattr_getpshared(3T) 
pthread_rwlockattr_getpshared(3T) 
.whodo(lM) 
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processes currently using a file or file structure. 

processes on system, display and update information about top ... 

processes to complete, wait for background . 

processes, alter priority of running . 

processes, kill all active. 

processes, Network Information Service (NIS) binder. 

processes, spawn . 

processing language, text pattern scanning and. 

processing system, interactive mail message. 

processor for C, Ratfor and other programming language macros 

processor IDs, determined. 

processor initialization . 

processor self test. 

processor type, determi ne . 

processor-dependent code (firmware). 

processors, bind threads to. 

processors, how many installed in the system . 

Product Description Fileformat . 

Product Description File, check against file system. 

Product Description File, create from an input . 

product specification fileformat . 

products, verify software . 

prof - display monitor profile data. 

profil () - execution time profile. 

profile data, display call graph execution . 

profile data, display monitor . 

profile file. 

profile of execution, prepare. 

profile - shell script to set up user's environment at login . 

profile, execution time. 

program assertion, verify . 

program file, locate, including aliases and paths. 

program files that execute under given command name, find . 

program for SCCS commands . 

program . 

program loaded module. 

program loaded module . 

program message, get an NLS . 

program number database, RPC . 

program regions, first locations beyond allocated . 

program start-up, prepare for faster. 

program termination, register a function to be called at. 

program's internal attributes, change. 

program, get or set the locale of a . 

programming language macro processor . 

programming values and constants, machine-dependent. 

programs from a disk device; update, install, or remove boot. 

programs - maintain, update, and regenerate groups of. 

programs, a compiler/interpreter for modest-sized . 

programs, FIALGOL, execute . 

programs, input editor and command history for interactive . 

prompt . 

propagation of a Network I nformation Service database, force .... 

protect terminal from use by others. 

protected password database entry, manipulate. 

protections, modify memory mapping access. 

proto - prototype job file for at . 

protocol address (X/OPEN XTI). 

protocol attribute, get or set. 

protocol entry, get, set, or end . 

protocol family, Internet . 


Entry Name(Section) 

.fuser(lM) 

.top(l) 

.wait(l) 

.renice(l) 

.killall(lM) 

.ypserv(lM) 

. init(lM) 

.awk(l) 

.mailx(l) 

.m4(l) 

.pthread_processor_bind_np(3T) 

.pdc(lM) 

. pdc(lM) 

.sysconf(2) 

.pdc(lM) 

.pthread_processor_bind_np(3T) 

.pthread_processor_bind_np(3T) 

.pdf(4) 

.pdfck(lM) 

.mkpdf(lM) 

.swpackage(4) 

.swverify(lM) 

.prof(l) 

.profil (2) 

.gprof(l) 

.profd) 

.logind) 

.monitor(3C) 

.profil e( 4) 

.profil (2) 

.assert(3X) 

.which(l) 

.which(l) 

.sccs(l) 

.glossary (9) 

.dlget(3C) 

.dlmodinfo(3C) 

.catgets(3C) 

.rpc(4) 

.end(3C) 

.fastbind(l) 

.atexit(2) 

.chatr(l) 

.setlocale(3C) 

.m4d) 

.values(5) 

.mkboot(lM) 

.make(l) 

.bs(l) 

.opx25(lM) 

.ied(l) 

.glossary (9) 

.yppush(lM) 

.lock(l) 

.getprpwent(3) 

.mprotect(2) 

.proto(4) 

.t_getprotaddr(3) 

pthread_mutexattr_getprotocol(3T) 

.getprotoent(3N) 

.inet(7F) 
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protocol module, remote magnetic tape dump and restore. rmt(lM) 

protocol name database . protocols(4) 

protocol server, filetransfer . ftpd(lM) 

protocol server, for TCP/IP I DENT. identd(lM) 

protocol server, TELNET . telnetd(lM) 

protocol server, trivial filetransfer. tftpd(lM) 

protocol, address resolution . arp(7P) 

protocol, Internet user datagram . UDP(7P) 

Protocol, IP Internet . IP(7P) 

protocol, local communication domain. UNIX(7P) 

Protocol, TCP I nternet Transmission Control . TCP(7P) 


protocol, user interfacetotheTELNET . 

protocol-specific service information (X/OPEN TLI-XTI) . 

protocols - protocol name database. 

prototype job filefor at . 

provide semaphores and record locking on files . 

provide sequential archive member access for ELF files. 

prpwd - protected password database. 

prs - print and summarizean SCCS file. 

prtacct - print any total accounting (tacct) file. 

ps - report process status. 

PS/2 keyboard and mouse device driver . 

ps 2 - PS/2 keyboard and mouse device driver . 

ps2kbd - PS/2 keyboard device file . 

ps2mouse - PS/2 mouse device file. 

pscan - scan HP SCSI disk array LUNsfor parity consistency. 

pseudo-random numbers, generate uniformly distributed . 

pseudo-terminal driver . 

pseudo-terminal master driver, STREAMS . 

pseudo-terminal slave driver, for STREAMS . 

pseudo-terminal slave driver, for STREAMS . 

pseudo-terminal, get name of user's terminal or. 

pseudo-terminal, Packet Mode modulefor STREAMS pty . 

pseudo-terminal, STREAMS Emulation module. 

pseudorandom number generation functions. 

PSF format . 

pstato - get system information . 

pstato - set system information . 

pstat getdisk () - get disk information . 

pstat getdynamic () - get dynamic system information . 

pstat getfile () - get open file information . 

pstat getipc () - get I PC information . 

pstat getiv() - get logical volume information . 

pstat getiwp () - get lightweight process or thread information . 

pstat getmsg () - get message queue information . 

pstat getproc () - get information about a process. 

pstat getprocessor () - get information about a processorl. 

pstat getprocvm() - get process address space information. 

pstat getsem() - get semaphore set information . 

pstat getshm() - get shared memory segment information . 

pstat getstabie () -get information contained in system's stable storage area 

pstat getstatic () - get static system information . 

pstat getswap () - get swap area information . 

pstat getvminfo () - get virtual memory information . 

ptem - STREAMS pty (pseudo-terminal) Emulation module. 

pthread register fork handler . 

pthread() - introduction to POSlX.lc threads . 

pthread at fork () - register fork handler . 

pthread attr_destroy () - destroy a thread attribute object. 


.telnet(l) 

.t_geti nfo(3) 

.protocols(4) 

.proto(4) 

.lockf(2) 

.elf_next(3E) 

.prpwd(4) 

.prs(l) 

.acctsh(lM) 

.ps(l) 

.ps2(7) 

.ps2(7) 

.ps2(7) 

. ps2(7) 

.pscan (INI) 

.drand48(3C) 

. pty(7) 

.ptm(7) 

.pts(7) 

. tels(7) 

.tty(l) 

.pckt(7) 

.ptem(7) 

.random(3M) 

.swpackage(4) 

.pstat(2) 

.pstat(2) 

.pstat(2) 

.pstat(2) 

.pstat(2) 

.pstat(2) 

. pstat(2) 

. pstat(2) 

.pstat(2) 

.pstat(2) 

.pstat(2) 

.pstat(2) 

.pstat(2) 

.pstat(2) 

.pstat(2) 

.pstat(2) 

.pstat(2) 

.pstat(2) 

.ptem(7) 

.pthread_atfork(3T) 

.pthread(3T) 

.pthread_atfork(3T) 

pth r ead_attr_destr oy (3T) 


pthread attr_getdetachstate () - get the detachstate attribute. pthread_attr_getdetachstate(3T) 


pthread attr_getguardsize () - get the guardsize attribute. pthread_attr_getdetachstate(3T) 
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pthread attr getinheritsched () - get the inheritsched attribute.pthread_attr_getdetachstate(3T) 

pthreadattr getprocessor_np () - get the processor 

and binding_typeattributes.pthread_attr_getdetachstate(3T) 

pthreadattr getschedparam() - get the schedparam attribute .pthread_attr_getdetachstate(3T) 

pthread attr getschedpolicy () - get the schedpolicy attribute .pthread_attr_getdetachstate(3T) 

pthread attr getscope () - get the contentionscope attribute .pthread_attr_getdetachstate(3T) 

pthread attr getstackaddr () - get the stackaddr attribute.pthread_attr_getdetachstate(3T) 

pthread attr getstacksize () - get the stacksize attribute.pthread_attr_getdetachstate(3T) 

pthread_attr_init () - i nitializea thread attribute object .pthread_attr_init(3T) 

pthread_attr_setdetachstate () - set the detachstateattribute .pthread_attr_getdetachstate(3T) 

pthread_attr_setguradsize () - set the guardsizeattribute .pthread_attr_getdetachstate(3T) 

pthread_attr_setinheritsched() - set the inheritsched attribute.pthread_attr_getdetachstate(3T) 

pthread_attr_setprocessor_np () - set the processor 

and binding_typeattributes.pthread_attr_getdetachstate(3T) 

pthread_attr_setschedparam() - set the schedparam attribute.pthread_attr_getdetachstate(3T) 

pthread_attr„setschedpolicy () - set the schedpolicy attribute.pthread_attr_getdetachstate(3T) 

pthread_attr_setscope () - set the contentionscope attribute.pthread_attr_getdetachstate(3T) 

pthread_attr_setstackaddr () - set the stackaddr attribute.pthread_attr_getdetachstate(3T) 

pthread_attr_setstacksize () - set the stacksize attribute .pthread_attr_getdetachstate(3T) 

pthread cancel () - cancel execution of a thread .pthread_cancel(3T) 

pthread cleanupj?op () - remove a thread cancellation cleanup handler.pthread_cleanup_pop(3T) 

pthread cleanupj>ush () - register a thread cancellation cleanup handler .pthread_cleanup_pop(3T) 

pthread condattr_destroy () - destroy a thread condition variable 

attributes object .pthread_condattr_init(3T) 

pthread condattr_getpshared () - get the thread process-shared 

attribute .pthread_condattr_getpshared(3T) 

pthread condattr_init () - initializea thread condition variable 

attributes object .pthread_condattr_init(3T) 

pthread condattr_setpshared () - set the thread process-shared 

attribute .pthread_condattr_getpshared(3T) 

pthread cond broadcast () - unblock all threads waiting on a condition variable. pthread_cond_signal(3T) 

pthread cond destroy () - destroy a thread condition variable.pthread_cond_init(3T) 

pthread cond init () - initializea thread condition variable.pthread_cond_init(3T) 

pthread cond signal () - unblock one thread waiti ng on a condition variable .pthread_cond_signal(3T) 

pthread cond timedwait () - timedwait on a thread condition variable.pthread_cond_wait(3T) 

pthread cond wait () - wait on a thread condition variable .pthread_cond_wait(3T) 

pthread continue () - continue execution of a thread .pthread_resume_np(3T) 

pthread create () - create a new thread of execution .pthread_create(3T) 

pthread defauit_stacksize np () - change the default stacksize.pthread_default_stacksize_np(3T) 

pthread detach () - mark a thread as detached to reclaim its resources when terminate pthread_detach(3T) 

pthread equal () - compare two thread identifiers.pthread_equal(3T) 

pthread exit () - cause the call ing thread to terminate .pthread_exit(3T) 

pthread getconcurrency () - get concurrency level of unbound threads .pthread_getconcurrency(3T) 

pthread getschedparam () - get the scheduling policy and associated 

parameters .pthread_getschedparam(3T) 

pthread getspecific () - get the thread-specific data associated with a key.pthread_getspecific(3T) 

pthread join () - wait for the termination of a specified thread .pthreadJoin(3T) 

pthread key_create () - create a thread-specific data key .pthread_key_create(3T) 

pthread key destroy () - destroy a thread-specific data key .pthread_key_create(3T) 

pthread kill () - send a signal to a thread .pthread_kill(3T) 

pthread mutexattr destroy () - destroy a mutex attribute object .pthread_mutexattr_init(3T) 

pthread mutexattr getprioceiling () - get the prioceiling attribute 

.pthread_mutexattr_getprotocol(3T) 

pthread mutexattr getprotocol () - get the protocol attribute .pthread_mutexattr_getprotocol(3T) 

pthread mutexattr getpshared () - get the process-shared attribute pthread_mutexattr_getpshared(3T) 

pthread mutexattr getspin np () - get the spin attribute.pthread_mutexattr_getspin_np(3T) 

pthread mutexattr gettype () - get the type attribute .pthread_mutexattr_getpshared(3T) 

pthread mutexattr_init () - initializea mutex attribute object .pthread_mutexattr_init(3T) 

pthread mutexattr_setprioceiling () - set the prioceiling attribute 

.pthread_mutexattr_getprotocol(3T) 

pthread mutexattr_setprotocol () - set the protocol attribute.pthread_mutexattr_getprotocol(3T) 
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pthread_mutexattr_setpshared() - set the process-shared attribute pthread_mutexattr_getpshared(3T) 

pthread mutexattr_setspin_np () - set thespin attribute .pthread_mutexattr_getspin_np(3T) 

pthread mutexattr_settype () - set the type attribute.pthread_mutexattr_getpshared(3T) 

pthread mutex_destroy () - destroy a mutex .pthread_mutex_init(3T) 

pthread_mutex_getprioceiling () - get the prioceiling of a mutex . pthread_mutex_getprioceiling(3T) 

pthread_mutex_getyieidfreq_np () - get theyield frequency attribute 

.pthread_mutexattr_getspin_np(3T) 

pthread_mutex_init () - initializea mutex .pthread_mutex_init(3T) 

pthread_mutex_lock () - lock a mutex .pthread_mutex_lock(3T) 

pthread mutex_setprioceiling () - set the prioceiling of a mutex . pthread_mutex_getprioceiling(3T) 

pthread_mutex_setyieidfreq_np () - set theyield frequency attribute 

.pthread_mutexattr_getspin_np(3T) 

pthread mutex_trylock () - try to lock a mutex .pthread_mutex_lock(3T) 

pthread mutex_unlock () - unlock a mutex .pthread_mutex_unlock(3T) 

pthread numjirocessorjp () - return how many processors are 

installed in the system .pthread_processor_bind_np(3T) 

pthread once () - call an initialization routine only once.pthread_once(3T) 

pthreadjrocessor bind np () - bi nd threads to processors.pthread_processor_bind_np(3T) 

pthread_processor„id_np () - determine processor I Ds .pthread_processor_bind_np(3T) 

pthread resume np () - resume execution of a thread .pthread_resume_np(3T) 

pthread rwiockattr_destroy () - destroy a read-write lock attribute object . pthread_rwlockattr_init(3T) 
pthread rwiockattr_getpshared () - get the process-shared attribute 

.pthread_rwlockattr_getpshared(3T) 

pthread rwiockattr„init () - initializea read-write lock attribute object . pthread_rwlockattr_init(3T) 

pthread rwiockattr_setpshared () - set the process-shared attribute 

.pthread_rwlockattr_getpshared(3T) 

pthread rwlock destroy () - destroy a read-write lock.pthread_rwlock_init(3T) 

pthread rwiock_init () - initializea read-write lock.pthread_rwlock_init(3T) 

pthread rwlock rdiock () - lock a read-write lock for reading.pthread_rwlock_rd!ock(3T) 

pthread rwiock_tryrdiock () - attempt to lock a read-write lock for reading . pthread_rwlock_rdlock(3T) 
pthread rwiock_trywriock () - attempt to lock a read-write lock for writing . pthread_rwlock_wrlock(3T) 

pthread rwlock uniock () - unlock a read-write lock .pthread_rwlock_unlock(3T) 

pthread rwlock wriock () - lock a read-write lock for writing .pthread_rwlock_wrlock(3T) 

pthread self () - obtai n the thread ID for the call ing thread .pthread_self(3T) 

pthread setcanceistate () - set and retrieve the current thread's cancelability state 

.pthread_setcancelstate(3T) 

pthread setcanceitype () - set and retrieve the current thread's cancelability type 

.pthread_setcancelstate(3T) 

pthread setconcurrency () - set concurrency level of unbound threads.pthread_getconcurrency(3T) 

pthread setschedparam () - set the scheduling policy and associated 

parameters .pthread_getschedparam(3T) 

pthread setspecific () - set the thread-specific data associated with a key .pthread_getspecific(3T) 

pthreadsigmask () - exami ne and change the signal mask of thecallingthread .pthread_sigmask(3T) 

pthread suspend () - suspend execution of a thread .pthread_resume_np(3T) 

pthread testcancel () - process any pending cancellation requests.pthread_testcancel(3T) 

ptm - STREAMS master pty (pseudo-terminal) driver.ptm(7) 

ptrace () - process trace.ptrace(2) 

pts - STREAMS slave pty (pseudo-terminal) driver .pts(7) 

ptsname () - get the name of a slave pty.ptsname(3C) 

ptsname_r() - get the name of a slave pty.ptsname(3C) 

ptx - generate permuted index .ptx(l) 

pty - get the name of the user's pseudo-terminal .tty(l) 

pty master driver, STREAMS .ptm(7) 

pty - pseudo-terminal driver.pty(7) 

pty, get the name of a slave.ptsname(3C) 

public key, database.publickey(4) 

publickeys, update, in a NIS+directory object .nisupdkeys(lM) 

publicor secret key, retrieve.getpublickey(3M) 

public U NIX system to U NIX system file copy .uuto(l) 

pubiickey database file, creating new key in.newkey(lM) 

publ i ckey database file, updates to.udpublickey(lM) 


HP-UX Release 11.0: October 1997 


Hewlett-Packard Company Index-115 




















































Index 
All Volumes 


Description Entry Name(Section) 

pubiickey - database for public keys.publickey(4) 

pubiickey () - retrieve publicor secret key.getpublickey(3M) 

push a character onto the input queue.ungetch(3X) 

push character back into input stream.ungetc(3S) 

push wide character back into input stream .ungetwc(3C) 

pushAgent - install Software Distributor agent on remote systems.pushAgent(lM) 

pushd - push directory stack.csh(l) 

pushed STREAMS modules, manage system database .autopush(lM) 

put a string on a stream.puts(3S) 

put character or word on a stream.putc(3S) 

put wide character on a stream .putwc(3C) 

put word or character on a stream.putc(3S) 

putc (), fputc () - put character on a stream.putc(3S) 

putchar () - put character on stream standard output.putc(3S) 

putdvagnam () - add or rewrite device assignment databaseentry.getdvagent(3) 

putenv() -changeor add valuetoenvironment.putenv(3C) 

putmsgt) - send a message on a stream.putmsg(2) 

putp () - output commands to the terminal .putp(3X) 

putpmsg () - send a message on a stream in different priority bands.putmsg(2) 

putprdf nam () - mani pul ate system default databaseentry .getprdfent(3) 

putprpwnam () - mani pul ate protected password databaseentry .getprpwent(3) 

putprtcnam() - manipulateterminal control databaseentry .getprtcent(3) 

putpwent () - write password file entry .putpwent(3C) 

puts() - write null-terminated string to stream stdout () .puts(3S) 

pututiine () - updateor create entry in a utmp () file.getut(3C) 

pututiine_r () - updateor create entry in a utmp() file.getut(3C) 

pututxiine () - updateor create entry in a utmpx () file.getutx(3C) 

putw() - put word (integer) on a stream.putc(3S) 

putwc (), fputwc () - put wide character on a stream .putwc(3C) 

putwchar () - put wide character on stream standard output .putwc(3C) 

putwin() - dump window to and reload window from a file.getwin(3X) 

putws (), fputws() - write null-terminated wide string to a named stream file.putws(3C) 

pvchange - change characteristics and access path of physical volume in LVM volume group.pvchange(lM) 

pvck - check or repair a physical volumein LVM volume group.pvck(lM) 

pvcreate - create physical volume for usein LVM volume group .pvcreate(lM) 

pvdisplay - display information about physical volumes in LVM volume group .pvdisplay(lM) 

pvmove - move allocated physical extents from one LVM physical volume to other physical volumespvmove(lM) 

pwck - password file checker .pwck(lM) 

pwconv - update secure password facility .pwconv(lM) 

pwd - print current working directory.ksh(l) 

pwd - print current working directory.sh-posix(l) 

pwd - print working directory name.pwd(l) 

pwd - working directory name.sh-bourne(l) 

pwget - get password information .pwget(l) 

pwgrd - password and group hashingand cashing daemon .pwgrd(lM) 

pwgr stat - passwrod and group hashingand caching statistics.pwgr_stat(lM) 

qif lush () - enabl^disable queue flushing.noqiflush(3X) 

qsort () - quicker sort.qsort(3C) 

queries and lists the status of one or more print jobs.pdq(l) 

query an NIS server for information about an NIS map.yppoll(lM) 

query functions for terminal insert and delay capability.has_ic(3X) 

query name servers interactively .nslookup(l) 

query numeric formatting conventions of current locale.localeconv(3C) 

query program, Network Time Protocol .ntpq(lM) 

query RIP gateways .ripquery(lM) 

query stream configuration.strchg(lM) 

query the Name Service Switch backend libraries .nsquery(l) 

query theterminfo database.tput(l) 

query, set configuration and loadableflagsfor a module.kmsystem(lM) 

query, set, or reset system parameter .kmtune(lM) 

queue a signal to a process .sigqueue(2) 
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queue description file for at, batch, and crontab . 

queue flushing, enable/disable . 

queue, input, push a character onto. 

queue, insert or remove an element. 

queue, prints the mail queue. 

queuedefs - queue descri ption file for at, batch, and crontab . 

quick batch mail interface. 

quicker sort. 

quit signal . 

quot - summarize file system ownership . 

quota consistency checker, generic file system . 

quota consistency checker, hfs file system. 

quota consistency checker, VxFS filesystem . 

quota - disk quotas . 

quota - display disk usage and limits . 

quota server, remote. 

quota status of specified file system, determine disk. 

quotacheck - generic file system quota consistency checker . 

quotacheck nf s - hfs file system quota consistency checker. 

quotacheck„vxfs - VxFS filesystem quota consistency checker . 

quotacti () - manipulatedisk quotas. 

quotaoff - turn file system quotas off . 

quotaon - turn filesystem quotas on . 

quotas, edit user. 

quotas, filesystem, turn on and off. 

quotas, manipulatedisk. 

quotas, summarize for a filesystem. 

quotient, remainder function with. 

quot_vxfs - summarize file system ownership . 

radix character . 

radix-independent exponent . 

radix-independent floating-point number, load exponent of. 

radix-independent floating-point number, load exponent of . 

raise a software signal. 

raise () - send signal to executing program. 

rand() - generate successive random numbers . 

random archive member access for ELF files . 

random inode generation numbers, install . 

random number generation functions. 

random(), srandom(), initstate (), setstate () - generate a pseudorandom number 

random-number generator, simple. 

ranlib - regenerate archive symbol table. 

rarpc - Reverse Address Resolution Protocol client . 

rarpd - Reverse Address Resolution Protocol daemon . 

raster display frame-buffer device access . 

raster frame-buffer display device access . 

rate of I/O data transfer, inform system of required minimum . 

Ratfor macro processor . 

raw disk . 

raw () - input mode control functions . 

rbootd - remote (diskless) boot server. 

rc - general purpose sequencer invoked upon entering new run level . 

resequences invoked upon entering new run level . 

rc.config - file containing system configuration information . 

rc. config.d - the location of files containing system configuration variableassignments 

rcancel - remove requests from line printer spooling queue on remote system . 

remd () - execute a command on a remote host. 

rep - remote file copy. 

rep - remote file copy. 

res - change RCS file attributes. 

RCS file attributes, change. 


.queuedefs(4) 

.noqiflush(3X) 

.ungetch(3X) 

.insque(3C) 

.mailq(l) 

.queuedefs(4) 

.fastmail(l) 

.qsort(3C) 

.glossary (9) 

.quot(lM) 

.quotacheck(lM) 

. quotachecknfs(lM) 
quotacheckvxfs(lM) 

.quota(5) 

.quota(l) 

.rquotad(lM) 

.fsclean(lM) 

.quotacheck(lM) 

. quotachecknfs(lM) 
quotacheckvxfs(lM) 

.quotacti (2) 

.quotaon(lM) 

.quotaon(lM) 

.edquota(lM) 

.quotaon(lM) 

.quotacti (2) 

.repquota(lM) 

.remquo(3M) 

.quot_vxfs(lM) 

.glossary (9) 

.logb(3M) 

.scalb(3M) 

.seal bn (3M) 

.ssignal(3C) 

.kill (2) 

.rand(3C) 

.elf_rand(3E) 

.fsirand(lM) 

.random(3M) 

.random(3M) 

.rand(3C) 

.ranlib(l) 

.rarpc(lM) 

.rarpd(lM) 

.framebuf(7) 

.framebuf(7) 

.io_speed_ctl(3l) 

.m4(l) 

.glossary (9) 

.cbreak(3X) 

.rbootd(lM) 

.rc(lM) 

.rc(lM) 

.rc.config(4) 

.rc.config(4) 

.r cancel (1M) 

.rcmd(3N) 

.rcp(l) 

.rcp(l) 

.rcs(l) 

.rcs(l) 
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Description 

RCS file format . 

RCS revisions, merge. 

RCS: change RCS file attributes . 

RCS: check in RCS revisions. 

RCS: check out RCS revisions. 

RCS: compare RCS revisions . 

RCS: description of commands. 

RCS: identify files in Revision Control System . 

RCS: merge RCS revisions. 

RCS: print log messages and other information about RCS files. 

rcsdiff - compare RCS revisions. 

rcsfile - format of RCS file . 

rcsintro - description of RCS commands. 

rcsmerge - merge RCS revisions . 

rdist - remote file distri bution program. 

rdpd - router discovery protocol daemon . 

rdump - incremental filesystem dump (for backups). 

re-open or open a stream file; convert file to stream. 

read a Iinefrom standard input . 

read a POSIX semaphore. 

read from crash dump . 

read from stream file or character string with formatted input conversion 

read - input and parse a line. 

read - input and parse a line. 

read mail or send mail to users . 

read one I inefrom user input . 

read password from terminal whilesuppressingecho. 

read - read a I inefrom standard input . 

read - read I inefrom standard input . 

read real-time priority. 

read stream up to next delimiter . 

read termination character on special file, set up I/O . 

read text string from message file. 

read valueof a symbolic link. 

read() - read contiguous data from a file. 

read, enableor disableblock during. 

read, I/O, determine how last terminated . 

read, start asynchronous . 

read-only file system. 

read-write lock attribute object, initializeor destroy. 

read-write lock for reading, lock or attempt to lock . 

read-write lock for writing, lock or attempt to lock . 

read-write lock, initializeor destroy. 

read-write lock, unlock . 

read/write file pointer, move. 

readable format, dump iconv translation tablesto . 

readdir () - get pointer to current entry in open directory . 

reading, open file for. 

readiink () - read valueof a symbolic link. 

readmail - read mail from specified mail folder . 

readonly - mark nameas read-only. 

readonly - mark names as unredefinable. 

readonly - mark names as unredefinable. 

reads and writes: STREAMS module. 

readv () - read noncontiguous data from a file. 

real and effective user I Ds, set . 

real group ID. 

real or effective user or group ID, get . 

real user ID . 

real, effective, and/or saved user or group IDs, set. 

real-time priority, execute process with. 


Entry Name(Section) 

. rcsfile(4) 

.rcsmerge(l) 

.rcs(l) 

.ci(l) 

.co(l) 

.rcsdiffd) 

.rcsintro(5) 

.ident(l) 

.rcsmerge(l) 

.rlog(l) 

.rcsdiffd) 

.rcsfile(4) 

.rcsintro(5) 

.rcsmerge(l) 

.rdistd) 

.rdpd(l) 

.dump(lM) 

.fopen(3S) 

.read(l) 

.sem_getvalue(2) 

.cr_read(3) 

.scanf(3S) 

.ksh(l) 

.sh-posix(l) 

.mail(l) 

.line(l) 

.getpass(3C) 

.read(l) 

.sh-bourne(l) 

.rtprio(2) 

.bgets(3G) 

.io_eol_ctl(3l) 

.gettxt(3C) 

.readlink(2) 

.read(2) 

.nodelay(3X) 

.io_get_term_reason(3l) 

.aio_read(2) 

.glossary (9) 

pthread_rwlockattr_init(3T) 
. pthread_rwlock_rdlock(3T) 
pthread)rwlock_wrlock(3T) 

.pthread_rwlock_init(3T) 

pthread_rwlock_unlock(3T) 

.Iseek(2) 

.dmpxlt(l) 

.directory(3C) 

.open (2) 

.readlink(2) 

.readmail(l) 

.sh-bourne(l) 

.ksh(l) 

.sh-posix(l) 

.tirdwr(7) 

.read(2) 

.setreuid(2) 

.glossary (9) 

.getuid(2) 

.glossary (9) 

. setresuid(2) 

.rtprio(l) 
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Description Entry Name(Section) 

real-time scheduling operations .rtsched(2) 

realloc () - change size of allocated memory block .malloc(3C) 

realpath () - resolve pathname.realpath(3X) 

realtime, POSIX extensions.aio(5) 

realtime, POSIX extensions .aio_cancel(2) 

realtime, POSIX extensions.aio_error(2) 

realtime, POSIX extensions.aio_fsync(2) 

realtime, POSIX extensions .aio_read(2) 

realtime, POSIX extensions.aio_return(2) 

realtime, POSIX extensions.aio_suspend(2) 

realtime, POSIX extensions.aio_write(2) 

realtime, POSIX extensions .lio_listio(2) 

realtime, POSIX extensions.mlock(2) 

realtime, POSIX extensions .mlockall(2) 

realtime, POSIX extensions.munlock(2) 

realtime, POSIX extensions.munlockall(2) 

reblock, convert, translateand copy a (tape) file.dd(l) 

reboot - reboot the system.reboot(lM) 

reboot system automatically after shutting system down.shutdown(lM) 

reboot system.boot(lM) 

reboot () - boot the system.reboot(2) 

reboots, evaluate time between.last(l) 

rebuild Network I nformation Service database, create or.ypmake(lM) 

rebuilds the database for the mail aliases file.newaliases(lM) 

receipt of a signal, define what to do upon .signal(2) 

receive a message from a message queue .mq_receive(2) 

receive error messages from the STREAMS log driver .strerr(lM) 

receive message from a socket.recv(2) 

receive message from message queue .msgop(2) 

recognized login shells, list of.shells(4) 

reconfigure, unconfigure, configure installed software .swconfig(lM) 

record displayed CRT terminal output simultaneously in a file.script(l) 

record file, session, created by acctconi, print.acctsh(lM) 

record locking and semaphores on files, provide.lockf(2) 

record, audit, write for self-auditing process .audwrite(2) 

records or files, move magnetic tape forward or backward by.mt(l) 

recover disk space.freedisk(lM) 

recover files selectively from backup media.frecover(lM) 

recursively descend a directory hierarchy, executing a function.ftw(3C) 

recursively expands the sendmaiI aliases.expandalias(l) 

recv () - receive message from a socket.recv(2) 

recvf rom () - receive message from a socket.recv(2) 

recvmsg () - receive message from a socket.recv(2) 

red - restricted line-oriented text editor .ed(l) 

redefine default login shell .chsh(l) 

redefine environment for command execution.env(l) 

redrawwin() -1 ine update status functions .redrawwin(3X) 

reduce LVM volume group by removing physical volumes.vgreduce(lM) 

reduce multipleadjacent blank linesto singleblank line.ssp(l) 

reference manual, introduction.Introduction^) 

reference pages, macro package for formatting.man (5) 

reformat and copy a (tape) file.dd(l) 

reformat or change a text file.newform(l) 

refresh control function, for window.touchwin(3X) 

refresh control functionsfor window.is_linetouched(3X) 

refresh the pad immediately after writing a character rendition.pechochar(3X) 

refresh the window immediately after writing a complex character .echo_wchar(3X) 

refresh () - refresh windows and lines.doupdate(3X) 

refresh, determine whether a screen has been refreshed .isendwin(3X) 

regcmpt) - compile a regular expression .regcmp(3X) 

regcompO - regular expression matching routines.regcomp(3C) 
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Description 

regenerate, maintain, and update groups of programs. 

regerror () - regular expression matching routines. 

regex () - execute a regular expression against a string . 

regexec() - regular expression matching routines. 

regfree () - regular expression matching routines. 

region, initializesemaphore in mapped file or anonymous memory . 

region, remove semaphore in mapped file or anonymous. 

region, unmap a mapped . 

regions, first locations beyond allocated program . 

register a function to be called at program termination. 

register fork handler . 

register or remove a thread cancellation cleanup handler. 

register or unregister loadable kernel modules with the running kernel 

register/cancel a notification request with a message queue. 

registerrpc () - obsolete library routines for RPC . 

regular expression and pattern matching notation definitions. 

regular expression compile and match routines . 

regular expression . 

regular expression matching routines. 

regular expression, compile or execute against a string . 

regular expressions, compile and execute. 

regular file. 

rehash - recompute internal hash table. 

reinitialize(erase) mass storage media (use-r option) . 

reject - prevent LP printer queuing requests. 

reject/select lines common to two sorted files. 

relational database, join two relations in . 

relative path name . 

relative window creation function . 

relatively arm a per-process timer . 

release blocked signalsand atomically wait for interrupt . 

release level of operating system, display. 

release level of operating system, get . 

release of operating system, display. 

release of operati ng system, get . 

reload window from a file. 

relocatable file, generate from object files and libraries. 

reitimer () - relatively arm a per-process ti mer . 

remainder function. 

remainder function with quotient. 

remainder functions. 

remainder () - remainder function. 

remainder, integer division and . 

remexportent () - access exported file system i nformation . 

remind you when you have to leave. 

reminder service. 

remote (diskless) boot server. 

remote backup over network . 

remote command, return a stream to. 

remote command, return stream to a . 

remote commands, return streams to (parallel) . 

Remote Enablelineon HP-IB, control the. 

remote execution server. 

remote execution server, RPC-based. 

remote file copy. 

remote file copy. 

remote file distri bution . 

remote file system, perform Network FileSystem mount to . 

remote file system, restore incrementally. 

remote host, execute a command on a. 

remote host, execute command on a . 


Entry Name(Section) 

.make(l) 

.regcomp(3C) 

.regcmp(3X) 

.regcomp(3C) 

.regcomp(3C) 

.msem_init(2) 

.msem_remove(2) 

.munmap(2) 

.end(3C) 

.atexit(2) 

.pthread_atfork(3T) 

pth r ead_cl ean u p_pop(3T) 

.kmmodreg(lM) 

.mq_notify(2) 

.rpc_soc(3N) 

.regexp(5) 

.regexp(3X) 

.glossary(9) 

.regcomp(3C) 

.regcmp(3X) 

.re_comp(3X) 

.glossary(9) 

. csh(l) 

.mediainit(l) 

.accept(lM) 

.comm(l) 

.join(l) 

.glossary (9) 

.derwin(3X) 

.reltimer(3C) 

.sigpause(2) 

.uname(l) 

.uname(2) 

.uname(l) 

.uname(2) 

.getwin(3X) 

. Id(l) 

.reltimer(3C) 

.remainder(3M) 

.remquo(3M) 

.fmod(3M) 

.remainder(3M) 

.div(3C) 

.exportent(3N) 

.leave(l) 

.calendar(l) 

.rbootd(lM) 

.dump(lM) 

.rcmd(3N) 

.rexec(3N) 

.prcmd(3N) 

.hpib_ren_ctl(3l) 

.rexecd(lM) 

.rexd(lM) 

.rcp(l) 

.rcp(l) 

.rdist(l) 

.vhe_u_mnt(lM) 

.rvxrestore(lM) 

.rcmd(3N) 

.on(l) 
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Description 

remote hosts and users, authorizing access on local host . 

remote incremental filesystem dump (for backups) . 

remote incremental filesystem restore . 

remote kernel, get performance data from. 

remote I ogi n . 

remote I ogi n server. 

remote machines, return information about users on. 

remote machines, write to specified . 

remote magnetic tape dump and restore protocol module. 

remote mounts, show all . 

remote node, get file handlefor file on . 

remote quota server. 

remote shell server. 

remote shel I, execute from a . 

remote system over LAN, log in on a . 

remote system, send L P request to. 

remote systems, cancel LP spooling requests sent to. 

remote systems, daemon for LP requests from. 

remote terminal, spawn getty to (call terminal) . 

remote transport provider user (X/OPEN TLI-XTI) . 

remote user communication server. 

remote user information server. 

remote user, verify as a local user. 

remote uucp or uux command requests, execute on local system . 

remotely mounted filesystems, keep track of . 

remove a delta from an SCCS file. 

remove a directory file. 

remove a file or directory. 

remove a LIF file. 

remove a message queue, semaphore set, or shared memory identifier ... 

remove a printer for use with tsm, add. 

remove a special (device) file. 

remove all blank lines from file . 

remove and unconfigure software products . 

remove boot programs from a disk device, install, update, or. 

remove directory entry. 

remove directory . 

remove DOS files or directories. 

remove extra new-line characters from file. 

remove file that is not listed in any directory. 

remove logical volumes from LVM volume group. 

remove LVM logical volume link to root, primary swap, or dump volume 

remove LVM volume group definition from the system . 

remove multiple line-feeds from output. 

remove NIS+directories. 

remove NIS+ objects from the namespace . 

remove nroff/troff, tbl, and neqn constructs . 

remove or insert an element in a queue. 

remove or register a thread cancellation cleanup handler. 

remove outdated STREAMS error log files . 

remove physical volumes from an LVM volume group . 

remove preprocessor lines . 

remove reverse I i ne-feeds and backspaces from text . 

remove semaphore in mapped file or anonymous region . 

remove symbol and line number information from an object file. 

remove user crontabfile. 

remove () - remove a file. 

remove, create directories in a path . 

removes all jobs from the specified object . 

removes print jobs. 

remque () - remove an element in a queue. 


Entry Name(Section) 

.hosts.equiv(4) 

.dump(lM) 

.restore(lM) 

.rstat(3N) 

.rlogin(l) 

.rlogind(lM) 

.rnusers(3N) 

.rwall(3N) 

.rmt(lM) 

.showmount(lM) 

.getfh(2) 

.rquotad(lM) 

.remshd(lM) 

.remsh(l) 

.vt(l) 

.rlp(lM) 

.rcancel(lM) 

.rlpdaemon(lM) 

.ct(l) 

.t_rcvudata(3) 

.talkd(lM) 

.fingerd(lM) 

.rcmd(3N) 

.uuxqt(lM) 

.mount(3N) 

.rmdel(l) 

.rmdir(2) 

.rm(l) 

.lifrm(l) 

.ipcrm(l) 

.tsm.lpadmin(lM) 

.rmsf(lM) 

.rmnl(l) 

.swremove(lM) 

.mkboot(lM) 

.unlink(2) 

.rmdir(l) 

.dosrm(l) 

.rmnl(l) 

.clri(lM) 

.Ivremove(lM) 

.Ivrmboot(lM) 

.vgremove(lM) 

.ssp(l) 

.nisrmdir(l) 

.nisrm(l) 

.deroff(l) 

.insque(3C) 

pthread_deanup_pop(3T) 

.strclean(lM) 

.vgreduce(lM) 

.unifdef(l) 

.col (1) 

.msem_remove(2) 

.strip(l) 

.crontab(l) 

.remove(3C) 

.mkdirp(3G) 

.pdclean(l) 

.pdrm(l) 

.insque(3C) 
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Description Entry Name(Section) 

remquo () - remainder function with quotient.remquo(3M) 

remsh - execute from a remote shell .remsh(l) 

remshd - remote shell server.remshd(lM) 

rename directory .mv(l) 

rename file .mv(l) 

rename LI F files .lifrename(l) 

rename () - change the name of a file.rename(2) 

renditions and characters, draw lines from single-byte.hline(3X) 

renditions of characters in a window, change.chgat(3X) 

renice - alter priority of running processes .renice(l) 

reorganize a VxFS filesystem.fsadm_vxfs(lM) 

repair damaged filesystem (generic) .fsdb(lM) 

repair damaged FHFS filesystem .fsdb_hfs(lM) 

repair file system interactively and check consistency .fsck(lM) 

repair file system interactively and check consistency (generic) .fsck(lM) 

repair or check a physical volume in LVM volume group .pvck(lM) 

repair VxFS filesystem.fsck_vxfs(lM) 

repeat - execute command more than once.csh(l) 

repeated (adjacent) lines in a file, count, extract, or eliminate .uniq(l) 

repetitively affirmative responses.yes(l) 

replace selected characters .tr(l) 

report adjacent repeated lines in a file.uniq(l) 

report CPU time used .clock(3C) 

report daily system activity.sal(lM) 

report disk usage.du(l) 

report I/O statistics.iostat(l) 

report NIS+server statistics.nisstat(lM) 

report number of free CDFS, FHFS, or NFS filesystem disk blocks.df_hfs(lM) 

report number of free disk blocks on a VxFS filesystem.df_vxfs(lM) 

report number of free DOS disk clusters .dosdf(l) 

report number of free file system disk blocks (generic).df(lM) 

report process status.ps(l) 

report RPC information .rpcinfo(lM) 

report status of interprocess communication facilities.ipcs(l) 

report virtual memory statistics.vmstat(l) 

reporter, system activity.sar(lM) 

reposition or get pointer for I/O operations on a stream file.fseek(3S) 

repquota - summarize file system quotas.repquota(lM) 

request server, PFS mount.pfsmountd(lM) 

request, receive confirmation (X/OPEN TLI-XTI).t_rcvconnect(3) 

requested status condition becomes true, wait until the.hpib_status_wait(3l) 

requests on an LP printer.Ip(l) 

requests, daemon that responds to SNMP .snmpd(lM) 

requests, LP .seeLP requests 

requests, LP spooling, move to a specified destination .Ipsched(lM) 

required minimum I/O data transfer rate, inform system of .io_speed_ctl(3l) 

reserve a line for a dedicated purpose.ripoffline(3X) 

reserve disk space.prealloc(l) 

reserved port socket, return a .rcmd(3N) 

reset an I/O interface.io_reset(3l) 

reset FDDI interface, stop and .fddistop(lM) 

reset, set, or query system parameter .kmtune(lM) 

resettyt) - savetestoreterminal mode .resetty(3X) 

reset_prog mode () - restore shell terminal modes to "program" state .def_prog_mode(3X) 

reset shell mode () - restore terminal modes to "shell" state.def_prog_mode(3X) 

resize or reorganize a VxFS filesystem.fsadm_vxfs(lM) 

resolution protocol, address.arp(7P) 

resolve pathname.realpath(3X) 

resolver configuration file.resolver(4) 

resolver routines.resolver(3N) 

resource consumption limit, get or set system .getrlimit(2) 
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Description 

resource utilization, get information . 

respond to vt requests from other systems. 

response to parallel poll on HP-IB, control . 

response, ask for user response for SD-UX. 

responses, repetitively affirmative. 

restartterm() - i nterface to terminfo database. 

restore file system incrementally . 

restore file system incrementally, local or across network . 

restore - incrementally restore file system . 

restore or save file position indicator for a stream. 

restore shell terminal modes to "program" state . 

restore signal action . 

restore signal action . 

restore terminal mode. 

restore terminal modes to "shell" state. 

restore volume group configuration. 

restor^save stack environment for non-local goto. 

restricted mailer (send only). 

restricted shell for sendmail. 

restricted window attribute control functions . 

resubmits previously submitted print jobs . 

resume execution of a thread . 

resume or suspend auditing on current process. 

resvport () - return a reserved port socket . 

res_init () - resolver routines. 

res mkqueryO - resolver routines. 

res query () - resolver routines. 

res_search() - resolver routines. 

res_send() - resolver routines. 

retrieve and set the current thread's cancelability state and type . 

retrieve archive member header for ELF files. 

retrieve archive symbol tablefor ELF files. 

retrieve capabilities from theterminfo database. 

retrieve class-dependent object file header for ELF files . 

retrieve class-dependent program header tablefor ELF files. 

retrieve class-dependent section header for ELF files. 

retrieve crash dump information . 

retrieve file identification data for ELF files. 

retrieve information on loaded module (program or shared libary) 
retrieve information on loaded module (program or shared libary) 

retrieve name of load module. 

retrieve SD product from new SD media . 

retrieve uninterpreted file contents for ELF files . 

return a reserved port socket . 

return a stream to a remote command . 

return asynchronous I/O status. 

return character back into input stream . 

return - exit function with return value. 

return how many processors are installed in the system . 

return FIP-UX process priority. 

return information about users on remote machines. 

return integer absolute value . 

return maximum for scheduling policy. 

return minimum for scheduling policy . 

return network status. 

return POSIX process priority . 

return scheduling parameters. 

return scheduling policy. 

return - shell function return to invoking script. 

return - shell function return to invoking script. 

return status of FI P-l B i nterface. 


Entry Name(Section) 

.getrusage(2) 

.vtdaemon(lM) 

.hpib_card_ppoll_resp(3l) 

.swask(lM) 

.yes(l) 

.del_curterm(3X) 

.restore(lM) 

.vxrestore(lM) 

.restore(lM) 

.fgetpos(3S) 

.def_prog_mode(3X) 

.sighold(2V) 

.sigset(3C) 

.resetty(3X) 

.def_prog_mode(3X) 

.vgcfgrestore(lM) 

.setjmp(3C) 

.maii(l) 

.smrsh(lM) 

.attroff(3X) 

.pdresubmit(l) 

.pthread_resume_np(3T) 

.audswitch(2) 

.rcmd(3N) 

.resolver(3N) 

.resolver(3N) 

.resolver(3N) 

.resolver(3N) 

.resolver(3N) 

.pthread_setcancelstate(3T) 

.elfgetarhdr(3E) 

.elf_getarsym(3E) 

.tigetflag(3X) 

.elf_getehdr(3E) 

.elf_getphdr(3E) 

.elf_getshdr(3E) 

.cr_info(3) 

.elf_getident(3E) 

.dlget(3C) 

.dlmodinfo(3C) 

.dlgetname(3C) 

.swgettools(lM) 

.elf_rawfile(3E) 

.rcmd(3N) 

.rcmd(3N) 

.aio_return(2) 

.ungetc(3S) 

.sh-bourne(l) 

pthread_processor_bind_np(3T) 

.rtsched(2) 

.rnusers(3N) 

.abs(3C) 

.rtsched(2) 

.rtsched(2) 

.netstat(l) 

.rtsched(2) 

.rtsched(2) 

.rtsched(2) 

.ksh(l) 

.sh-posix(l) 

.hpib_bus_status(3l) 
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Description Entry Name(Section) 

return stream to a remote command .rexec(3N) 

return the size of an object file type for elf32 or elf64 files.elf_fsize(3E) 

return the state of the NIS+namespace using a conditional expression.nistest(l) 

return wide character back into input stream.ungetwc(3C) 

rev - reverse the text character sequence in each line of a file.rev(l) 

revck - check internal revision numbers of HP-UX files.revck(lM) 

Reverse Address Resolution Protocol client .rarpc(lM) 

Reverse Address Resolution Protocol daemon .rarpd(lM) 

reverse line-feeds and backspaces, remove from text .col(l) 

reverse order, show last commands executed in .lastcomm(l) 

reverse - reverse printer pages for collating .Ipfilter(l) 

reverse the left-to-right text character sequence in each line of a file .rev(l) 

Revision Control System.seeRCS 

revision numbers of HP-UX files, verify internal .revck(lM) 

revisions, compare RCS .rcsdiff(l) 

revisions, RCS, check in.ci(l) 

revisions, RCS, check out.co(l) 

rewind legal user shellsfile.getusershell(3C) 

rewind magnetic tape.mt(l) 

rewind () - set position of next I/O operation on stream file.fseek(3S) 

rewinddir () - reset position of named directory stream to beginning of directory.directory(3C) 

rewind uniocked () - set position of next I/O operation on stream file, 

no locking of stream for multi-thread applications.fseek(3S) 

rewrite an existing file.creat(2) 

rexd - RPC-based remote execution server.rexd(lM) 

rexec (), login information for.netrc(4) 

rexec () - return stream to a remote command .rexec(3N) 

rexecd - remote execution server.rexecd(lM) 

re_comp() - compile and execute regular expressions.re_comp(3X) 

re_exec () - compileand execute regular expressions.re_comp(3X) 

right or left justify linesfor N LS printing .nljust(l) 

right triangle, hypotenuse of a .hypot(3M) 

rights to a file, get a user's effective access .getaccess(2) 

rights, access, tofile(s), list.getaccess(l) 

rindex () - BSD portability string routine .string(3C) 

ring, list characteristics of nodes on FDDI .fddinet(lM) 

rint() - round to nearest int function .rint(3M) 

RIP gateways, query .ripquery(lM) 

ripoffiine() - reserve a linefor a dedicated purpose.ripoffline(3X) 

ripquery - query RIP gateways.ripquery(lM) 

rksh - restricted Korn shell command programming language.ksh(l) 

riog - print log messages and other information about RCS files .rlog(l) 

riogin - remote login .rlogin(l) 

riogind - remote login server.rlogind(lM) 

rip - send LP lineprinter request to a remote system .rlp(lM) 

rlpdaemon - lineprinter daemon for LP requests from remote systems.rlpdaemon(lM) 

ripstat - pri nt status of L P requests sent to remote system .rlpstat(lM) 

rm - remove files or directories.rm(l) 

rmaii - restricted mailer (send only).mail(l) 

rmboot - remove boot programs from a disk device.mkboot(lM) 

rmdei - remove a delta from an SCCS file.rmdel(l) 

rmdir - remove directories.rmdir(l) 

rmdir () - remove a directory file.rmdir(2) 

rmdirp () - remove directories in a path.mkdirp(3G) 

rmni - remove extra new-line characters from file.rmnl(l) 

rmsf - remove a special (device) file .rmsf(lM) 

rmt - remote magnetic tape protocol module.rmt(lM) 

rmtab - local filesystem mount statistics.rmtab(4) 

rmtimer () - free a per-process timer .rmtimer(3C) 

rnusers (): return information about users on remote machines.rnusers(3N) 

root directory .glossary(9) 
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root directory, change.chroot(2) 

root directory, change for a command .chroot(lM) 

root filesystem, prepare for migration from partitionsto LVM logical volumes .Ivmmigrate(lM) 

root volume.glossary(9) 

root volume, prepare LVM logical volume to be.Ivlnboot(lM) 

root volume, remove LVM logical volume link.Ivrmboot(lM) 

root, target, modify software products in depot or.swmodify(lM) 

roots and depots, register or unregister.swreg(lM) 

round function . round(3M) 

round to long function.lround(3M) 

round to long long function .llround(3M) 

round to nearest int functions.rint(3M) 

round to nearest long function .lrint(3M) 

round to nearest long long function .llrint(3M) 

round() - round function .round(3M) 

rounding mode: getting floating-point.fegetround(3M) 

rounding mode: setting floating-point .fesetround(3M) 

route and path between hosts, compute shortest.pathalias(l) 

route - manipulate routing tables manually.route(lM) 

router connection mapper, multicast .map-mbone(lM) 

router, electronic address.pathalias(l) 

routine for manipulating global RPC attribute for client and server applications.rpc_control(3N) 

routine for sorted tables, binary search.bsearch(3C) 

routine to retrieve user name, PAM .pam_get_user(3) 

routines for client side calls.rpc_clnt_calls(3N) 

routines for client sideremote procedure call authentication.rpc_clnt_auth(3N) 

routines for dealing with creation and manipulation of CLI ENT handles.rpc_clnt_create(3N) 

routines for external data representation .xdr(3N) 

routines for external data representation .xdr_admin(3N) 

routines for external data representation .xdr_complex(3N) 

routines for external data representation.xdr_simple(3N) 

routines for external data representation stream creation .xdr_create(3N) 

routines for PAM, authentication information .pam_set_item(3) 

routines for registering servers, rpc.rpc_svc_reg(3N) 

routines for remote procedure calls, rpc .rpc(3N) 

routines for remote procedure calls, XDR .rpc_xdr(3N) 

routines for RPC servers .rpc_svc_calls(3N) 

routines for secure remote procedure calls.secure_rpc(3N) 

routines for server sideremote procedure call errors .rpc_svc_err(3N) 

routines for thecreation of server handles, rpc.rpc_svc_create(3N) 

routines to maintain module specific state, PAM .pam_set_data(3) 

routines, authentication transaction routines for PAM .pam_start(3) 

routines, define label for formatting .setlabel(3) 

routines, emulate /etc/termcap access.termcap(3X) 

routines, Internet address manipulation .inet(3N) 

routines, library routines for RPC bind service.rpcbind(3N) 

routines, network station address string conversion .net_aton(3C) 

routines, obsolete library routines for RPC.rpc_soc(3N) 

routines, resolver.resolver(3N) 

routing daemon, gateway.gated(lM) 

routing daemon, IP multicast .mrouted(lM) 

routing - system support for local network packet routing .routing(7) 

routing tables manually, manipulate.route(lM) 

routing, multicast, configuration information tool .mrinfo(lM) 

RPC entry, get.getrpcent(3C) 

RPC information, report .rpcinfo(lM) 

rpc - library routines for remote procedure calls.rpc(3N) 

RPC port number, get .getrpcport(3N) 

RPC program number mapper, universal addresses to.rpcbind(lM) 

RPC protocols, generate C header files .rpcgen(l) 

rpc RPC program number database.rpc(4) 
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rpc, CLIENT handles, library routines for dealing with creation and manipulation of .rpc_clnt_create(3N) 

rpc, library routine for manipulating global RPC attribute for client and server applications .... rpc_control(3N) 

rpc, library routines for client side calls.rpc_clnt_calls(3N) 

rpc, library routines for client side remote procedure call authentication .rpc_clnt_auth(3N) 

rpc, library routines for registering servers .rpc_svc_reg(3N) 

rpc, library routines for remote procedure calls.rpc(3N) 

rpc, library routines for RPC bind service.rpcbind(3N) 

rpc, library routines for RPC servers.rpc_svc_calls(3N) 

rpc, library routines for secure remote procedure calls.secure_rpc(3N) 

rpc, library routines for the creation of server handles .rpc_svc_create(3N) 

rpc, obsolete library routines for RPC .rpc_soc(3N) 

RPC, secure, change user's key.chkey(l) 

RPC-based remote execution server.rexd(lM) 

rpc.nisd - NIS+service daemon .rpc.nisd(lM) 

rpc.nisd_resoiv - NIS+service daemon .rpc.nisd(lM) 

rpc. nispasswdd () - NIS+ password update daemon .rpc.nispasswdd(lM) 

rpc.pcnfsd - PC-NFS authentication and print request server .pcnfsd(lM) 

rpc.ypupdated, ypupdated, - server for changing NIS information .ypupdated(lM) 

rpcbind - universal addresses to RPC program number mapper.rpcbind(lM) 

rpcbind() -1ibrary routinesfor RPC bind service.rpcbind(3N) 

rpcbgetaddr () -1 ibrary routi nes for RPC bind service.rpcbind(3N) 

rpcb getmaps () - library routines for RPC bind service.rpcbind(3N) 

rpcb gettime () - library routines for RPC bind service.rpcbind(3N) 

rpcbrmtcaii () -1 ibrary routi nes for RPC bind service.rpcbind(3N) 

rpcbset () - library routi nes for RPC bind service.rpcbind(3N) 

rpcb unset () -1 ibrary routi nes for RPC bind service.rpcbind(3N) 

rpcgen - generate RPC protocols, C header files .rpcgen(l) 

rpcinfo - report RPC information .rpcinfo(lM) 

rpc broadcast () -1 ibrary routi nes for cl ient side calls .rpc_clnt_calls(3N) 

rpc broadcast exp () -1 ibrary routi nes for cl ient side calls .rpc_clnt_calls(3N) 

rpc caii () - library routines for client sidecalls .rpc_clnt_calls(3N) 

rpc cint auth () -1 ibrary routi nes for cl ient side remote procedure call authentication .... rpc_clnt_auth(3N) 

rpc cint calls () -1 ibrary routi nes for cl ient side calls .rpc_clnt_calls(3N) 

rpc cint create () - library routines for dealing with CLI ENT handles.rpc_clnt_create(3N) 

rpc control () - library routine for manipulating global RPC attributefor client and server 

applications.rpc_control(3N) 

rpc createerr () - library routines for dealing with CLIENT handles.rpc_clnt_create(3N) 

rpc reg () -1 ibrary routi nes for registeri ng servers .rpc_svc_reg(3N) 

rpc soc () - obsolete library routinesfor RPC .rpc_soc(3N) 

rpc_svc_caiis () - library routinesfor RPC servers.rpc_svc_calls(3N) 

rpc svc^create () - library routinesfor thecreation of server handles.rpc_svc_create(3N) 

rpc_svc_err() - library routinesfor server side remote procedure call errors.rpc_svc_err(3N) 

rpc_svc„reg () -1 ibrary routi nes for registeri ng servers .rpc_svc_reg(3N) 

rpc xdr () - XDR I ibrary routi nes for remote procedure calls.rpc_xdr(3N) 

rpr - repair parity information on an H P SCSI disk array LUN .rpr(lM) 

rquotad - remote quota server .rquotad(lM) 

rr scheduling policy.rtsched(2) 

RR2 scheduling policy.rtsched(2) 

rrestore - incrementally restore file system across network .restore(lM) 

rsh - restricted shell command programming language.sh-bourne(l) 

rsh - rshell, the restricted command programming language.sh-bourne(l) 

rstat () - get performance data from remote kernel .rstat(3N) 

rstatd- kernel statistics server.rstatd(lM) 

rtprio - execute process with real-time priority.rtprio(l) 

rtprio scheduling policy.rtsched(2) 

rtprio () -change or read real-time priority.rtprio(2) 

rtsched - execute process with POSIX real-time priority .rtsched(l) 

rtsched - real time scheduling operations.rtsched(2) 

run a command at nondefault priority .nice(l) 

run a command immune to hangups.nohup(l) 

run daily accounting.runacct(lM) 
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run level .init(lM) 

run-level s, place system in .shutdown(lM) 

runacct - accumulate accounti ng data and command usage summary.acctsh(lM) 

runacct - run daily accounting.runacct(lM) 

running processes, alter priority of .renice(l) 

rup: show host status of local machines (RPC version) .rup(l) 

ruptime - show status of local machines .ruptime(l) 

ruserok () - verify a remote user as a local user .rcmd(3N) 

rusers: determine who is logged in on local network machines .rusers(l) 

rusers (): return information about users on remote machines.rnusers(3N) 

rusersd - network username server .rusersd(lM) 

rvxdump - incremental file system dump across network.vxdump(lM) 

rvxrestore - restore file system incrementally across network .vxrestore(lM) 

rwall server, network.rwalld(lM) 

rwaii - write to all users over a network .rwall(lM) 

rwall (): write to specified remote machines .rwall(3N) 

rwaiid - network rwall server.rwalld(lM) 

rwho - show who is logged in on local machines .rwho(l) 

rwhod - system status server .rwhod(lM) 

sal, sa2, sadc - system activity report package.sal(lM) 

sal - collect and output or store system activity data in binary file.sal(lM) 

sa2 - write daily system activity report in binary file.sal(lM) 

sact - print current SCCS file editing activity.sact(l) 

sad - STREAMS Administrative Driver .sad (7) 

sadc - collect and output or store system activity data .sal(lM) 

SAM logfile, tool for viewing and saving.samlogviewer 

sam - system administration manager .sam(lM) 

samiog viewer - tool for viewing and saving the SAM logfile.samlogviewer(l) 

sar - system activity reporter .sar(lM) 

save a crash dump of the operating system .savecrash(lM) 

save or restore file position indicator for a stream.fgetpos(3S) 

save or restore program or shell terminal modes.def_prog_mode(3X) 

save terminal modes as the "shell" state.def_prog_mode(3X) 

save/restore stack environment for non-local goto.setjmp(3C) 

sav^restore terminal mode .resetty(3X) 

savecrash - save a crash dump of the operating system .savecrash(lM) 

saved group ID .glossary(9) 

saved process group ID .glossary(9) 

saved set-group-1 D .glossary(9) 

saved set-user-1 D .glossary(9) 

saved user ID . glossary(9) 

saved, real, and/or effective user or group IDs, set.setresuid(2) 

savetty () - sav^restore terminal mode .resetty(3X) 

saving, viewing SAM logfiletool .samlog viewer 

sbrk () - increase data segment space allocation .brk(2) 

scalb () - load exponent of a radix-independent floating-point number.scalb(3M) 

scaibn () - load exponent of a radix-independent floating-point number .seal bn (3M) 

scan a directory.scandir(3C) 

scan physical volumes for LVM volume groups .vgscan(lM) 

scan the I/O system for disk arrays.arrayscan(lM) 

scan the I/O system .ioscan(lM) 

scandir () - scan a directory.scandir(3C) 

scanf () - formatted read from standard input stream file.scanf(3S) 

scanner, big file .bfs(l) 

scanning and processing language, text pattern .awk(l) 

scanw() - convert formatted input from a window.mvscanw(3X) 

scatter data to check the network.spray(3N) 

SCCS (Source Code Control System) .glossary(9) 

SCCS command help.sccshelp(l) 

SCCS commands, utility program for .sccs(l) 

SCCS delta, change delta commentary of.cdc(l) 
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SCCS deltas, combine.comb(l) 

SCCS file format .sccsfile(4) 

SCCS file.glossary(9) 

sees - utility program for SCCS commands .sccs(l) 

SCCS, create and administer SCCS files.admin(l) 

SCCS: combine SCCS deltas.comb(l) 

SCCS: compare two versions of an SCCS file .sccsdiff(l) 

SCCS: get a version of an SCCS file.get(l) 

SCCS: get SCCS identification information from files.what(l) 

SCCS: make a delta (change) to an SCCS file.delta(l) 

SCCS: print and summarize an SCCS file .prs(l) 

SCCS: print current SCCS file editing activity.sact(l) 

SCCS: remove a delta from an SCCS file.rmdel(l) 

SCCS: undo a previous get of an SCCS file .unget(l) 

SCCS: validatean SCCS file.val(l) 

sccsdiff - compare two versions of an SCCS file .sccsdiff(l) 

sccsfile - format of SCCS file.sccsfile(4) 

sccshelp - help for SCCS commands .sccshelp(l) 

scheduieuuep transport files .uusched(lM) 

scheduler, LP, start or stop .Ipsched(lM) 

scheduling operations, real-time .rtsched(2) 

scheduling policy.rtsched(2) 

scheduling priority.renice(l) 

sched fifo scheduling policy.rtsched(2) 

sched getparam() - return scheduling parameters.rtsched(2) 

sched getscheduier () - return scheduling policy .rtsched(2) 

sched_get_priority_max () - return maximum for scheduling policy.rtsched(2) 

sched_get_priority_min () - return minimum for scheduling policy .rtsched(2) 

sched hpux scheduling policy.rtsched(2) 

sched other scheduling policy.rtsched(2) 

sched rr scheduling policy.rtsched(2) 

sched_rr 2 scheduling policy.rtsched(2) 

sched_rr_get_intervai () - update execution time limit .rtsched(2) 

sched rtprio schedul i ng pol icy.rtsched(2) 

sched setparam () - set scheduling parameters .rtsched(2) 

sched setscheduler () - set scheduling policy.rtsched(2) 

sched timeshare schedul i ng pol icy.rtsched(2) 

sched yieid () - force process to relinquish processor .rtsched(2) 

schgr - SCSI media changer device drivers.autochanger(7) 

sen - scan HP SCSI disk array LUNsfor parity consistency.scn(lM) 

screen file input/output functions.scr_dump(3X) 

screen initialisation functions.initscr(3X) 

screen size information, specify source.use_env(3X) 

screen, clear terminal.clear(l) 

screen, determine if it has been refreshed.isendwin(3X) 

screen, free storage associated with a screen .delscreen(3X) 

screen, number of columns.COLS(3X) 

screen, number of lines on .LINES(3X) 

screen-oriented mail interface .elm(l) 

screen-oriented text editor.vi(l) 

screen: flash the screen .flash(3X) 

screens, switch between .set_term(3X) 

script for the init process.inittab(4) 

script format and semantics, loealedef-command input .localedef(4) 

script - make typescript of terminal session.script(l) 

script to set up user's environment at login, shell .profile(4) 

scripts, symbolictranslationfilefor localedef.charmap(4) 

scri () - scroll the window, enhanced curses.scrl(3X) 

scroll a curses window .scroll(3X) 

scroll the window, enhanced curses.scrl(3X) 

scroll () - scroll a curses window .scroll(3X) 
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scroilok() -terminal output control functions .clearok(3X) 

scr dump () - screen file input/output functions.scr_dump(3X) 

scr_init () - screen file input/output functions.scr_dump(3X) 

scr_restore () - screen file input/output functions.scr_dump(3X) 

scr_set () - screen file input/output functions.scr_dump(3X) 

SCSI device drivers .scsi(7) 

SCSI device, control a.scsictl(lM) 

SCSI direct access device driver .scsi_disk(7) 

SCSI media changer device drivers.autochanger(7) 

SCSI pass-through device driver .scsi_ctl(7) 

SCSI pass-through device driver .scsi_pt(7) 

SCSI sequential access device driver .scsi_tape(7) 

scsicti - control a SCSI device.scsictl(lM) 

scsi_cti - SCSI pass-through device driver .scsi_ctl(7) 

scsi^disk - SCSI direct access device driver .scsi_disk(7) 

scsi_pt - SCSI pass-through device driver .scsi_pt(7) 

scsi_tape - SCSI sequential access device driver .scsi_tape(7) 

sd - create and monitor jobs.swjob(lM) 

sd - create, distribute, install, monitor, and manage software.sd(5) 

SD product from new SD media .swgettools(lM) 

sd - SD objects, attributes, and storage formats.sd(4) 

sdiff - compare two files and show differences side-by-side.sdiff(l) 

search a file for a string or expression .grep(l) 

search and print process accounting files .acctcom(lM) 

search directory tree for files.find(l) 

search environment list for valueof specified variablename.getenv(3C) 

search for files.find(l) 

search for named file in named directories .pathfind(3G) 

search path for dynamically loadable kernel modules, change.modpath(2) 

search physical volumes for LVM volume groups .vgscan(lM) 

search routine, binary, for sorted tables.bsearch(3C) 

search tablefor entry; optional update if missing.lsearch(3C) 

search tables, hash, manage.hsearch(3C) 

search tree, manage a binary .tsearch(3C) 

searching NIS+tables.nismatch(l) 

secof2 (), SECof2 () - test for valid second byte in 16-bit character.nl_tools_16(3X) 

secondary prompt .glossary(9) 

secret key, decrypt and store .keylogin(l) 

secret key, delete key stored with keyserv.keylogout(l) 

secret key, retrieve public or .getpublickey(3M) 

section data for ELF files, manipulate.elf_getdata(3E) 

section information for ELF files, get .elf_getscn(3E) 

section sizes and allocation space of object files, print.size(l) 

section sizes, disk, calculate default.disksecn(lM) 

secure internet services description.sis(5) 

secure internet services, configuration file.inetsvcs.conf(4) 

secure internet services, enableor disable.inetsvcs_sec(lM) 

secure password file, get entry from .getspwent(3X) 

secure remote procedure calls, library routines .secure_rpc(3N) 

secure RPC key, change user's.chkey(l) 

secured password facility, update.pwconv(lM) 

securenets (4) - NIS map security file .securenets(4) 

securetty file. login(l) 

secure rpc () - library routines for secure remote procedure calls.secure_rpc(3N) 

security databases.authcap(4) 

security file for ftpd(lM) .ftpusers(4) 

security file, inetd optional .inetd.sec(4) 

security file, map NIS .securenets(4) 

security files authorizing access by remote hosts and users on local host .hosts.equiv(4) 

security purposes, destroy mass storage data for (use -r option).mediainit(l) 

security, audio.seeaudio(5) 
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sed - streaming text editor .sed(l) 

see - access EEPROM bytes in an HP SCSI disk array controller .see(lM) 

seek; move read/write file pointer .Iseek(2) 

seekdir () - set position of next readdir () operation on named directory stream.directory(3C) 

seetreuid() - set real and effective user IDs .setreuid(2) 

segment, get shared memory.shmget(2) 

select code .glossary(9) 

select users to audit .audusr(lM) 

select () - synchronous I/O multiplexing .select) 2) 

select/reject lines common to two sorted files.comm(l) 

selected characters, alter, delete, modify, substitute, translate.tr(l) 

selected fields of each line in a file, cut out (extract) .cut(l) 

selected keys in Network Information Service map, print the values of .ypmatch(l) 

selectively recover files from backup media .frecover(lM) 

self-auditing process, write audit record for .audwrite(2) 

semantics, locaiedef-command input script format and .localedef(4) 

semaphore control operations .semctl(2) 

semaphore identifier (semid) .glossary(9) 

semaphore in mapped file or anonymous region, remove.msem_remove(2) 

semaphore in mapped file or anonymous memory region, initialize.msem_init(2) 

semaphore operation permissions.glossary(9) 

semaphore operations.semop(2) 

semaphore set identifier, remove.ipcrm(l) 

semaphore, lock a .msem_lock(2) 

semaphore, unlock a.msem_unlock(2) 

semaphores and record locking on files, provide.lockf(2) 

semaphores, get set of .semget(2) 

semaphores, report status.ipcs(l) 

semcti () - semaphore control operations.semctl(2) 

semget () - get set of semaphores.semget(2) 

semid (semaphore identifier) .glossary(9) 

semop() - semaphore operations .semop(2) 

sem ciose () - dose a named semaphore.sem_close(2) 

sem destroy () - destroy an unnamed semaphore .sem_destroy(2) 

sem getvaiue () - read a POSIX semaphore.sem_getvalue(2) 

sem init () - initializean unnamed semaphore.sem_init(2) 

sem open () - open/create a named semaphore.sem_open(2) 

sem_post () - unlock a POSIX semaphore.sem_post(2) 

sem trywait () - lock a POSIX semaphore without blocking.sem_wait(2) 

sem uniink() -unlinka named semaphore.sem_unlink(2) 

sem wait () - lock a POSIX semaphore.sem_wait(2) 

send a message on a stream.putmsg(2) 

send a message simultaneously to all users.wall(lM) 

send a message to a message queue.mq_send(2) 

send a signal to a process or a group of processes.sigsend(2) 

send a signal to a thread .pthread_kill(3T) 

send BOOTREQUEST to BOOTP server .bootpquery(lM) 

send command bytes over HP-IB .hpib_send_cmnd(3l) 

send commands toTerminal Session Manager .tsm.command(l) 

send copy of standard output to specified file.tee(l) 

send FibreChannel Lightweight Protocol Echo Request packet .pong(lM) 

send LP lineprinter request to a remote system .rlp(lM) 

send mail over the I nternet .sendmail(lM) 

send mail to users or read mail .mail(l) 

send message to a socket .send(2) 

send message to message queue.msgop(2) 

send ping to NIS+servers.nisping(lM) 

send signal to executing program.ki 11 (2) 

send signal to process.kill(l) 

send signalsto domain name server .sig_named(lM) 

send test packets .ping(lM) 
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send the contents of a file through a socket .sendfile(2) 

send() - send message to a socket .send(2) 

sendfile () - send thecontents of a filethrough a socket .sendfile(2) 

sendmail aliasesfile .aliases(5) 

sendmail aliases, print system-wide.praliases(l) 

sendmail aliases, recursively expands.expand alias(l) 

sendmail daemon, killing it.killsm(lM) 

sendmail database maps, creating.makemap(lM) 

sendmail - send mail over the I nternet .sendmail(lM) 

sendmail, restricted shell .smrsh(lM) 

sendmail.cf files, convert to new format.convert_awk(lM) 

sendmsg () - send message to a socket .send(2) 

sendto () - send message to a socket .send(2) 

send sound - play audiofile.send sound(l) 

separate a file into mul ti pie n-line pieces.split(l) 

separate double-precision number into mantissa and exponent.frexp(3M) 

separate mirrored LVM logical volume into two logical volumes .Ivsplit(lM) 

sequence for object codefiles in a library, find optimum.lorder(l) 

sequential access device driver, SCSI .scsi_tape(7) 

sequential archive member access for ELF files, provide.elf_next(3E) 

Serial and HP AdvanceLink server, Basic.pcserver(lM) 

serial modem line control, asynchronous .modem(7) 

serial poll on HP-lB bus, conduct a .hpib_spoll(3l) 

serialize - force target process to run serially with other processes.serialize(l) 

serialize () -force target process to run serially with other processes.serialized) 

server and client, NIS+, initialization utility .nisinit(lM) 

server for changing NIS information .ypupdated(lM) 

server for information about an NIS map, query an NIS.yppoll(lM) 

server for storing private encryption keys .keyserv(l) 

server or map master, list which host is Network Information System .ypwhich(l) 

server to local node, transfer NIS database from NIS.ypxfr(lM) 

server, Basic Serial and HP AdvanceLink.pcserver(lM) 

server, domain name, send signalsto .sig named(lM) 

server, file transfer protocol .ftpd(lM) 

server, Internet Boot Protocol .bootpd(lM) 

server, Internet domain name.named(lM) 

server, kernel statistics.rstatd(lM) 

server, network rwaii.rwalld(lM) 

server, network username.rusersd(lM) 

server, NFS mount request .mountd(lM) 

server, NIS+, statistics, report.nisstat(lM) 

server, PFS mount request.pfsmountd(lM) 

server, remote execution .rexecd(lM) 

server, remote login .rlogind(lM) 

server, remote quota.rquotad(lM) 

server, remote shell .remshd(lM) 

server, remote user information.fingerd(lM) 

server, RPC-based remote execution.rexd(lM) 

server, send BOOTREQUEST to BOOTP .bootpquery(lM) 

server, spray.sprayd(lM) 

server, system status .rwhod(lM) 

server, TELNET protocol .telnetd(lM) 

server, trivial file transfer protocol .tftpd(lM) 

servers, library routines for registering servers, rpc .rpc_svc_reg(3N) 

servers, library routines for RPC servers.rpc_svc_calls(3N) 

servers, library routines for server side remote procedure call errors.rpc_svc_err(3N) 

servers, library routines for the creation of server handles, rpc .rpc_svc_create(3N) 

servers, name, query interactively .nslookup(l) 

servers, set up NIS+.nisserver(lM) 

service daemon, NIS+ .rpc.nisd(lM) 

service entry, get, set, or end.getservent(3N) 
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service module APIs, PAM .pam_sm(3) 

service module, PAM user policy definition .pam_updbe(5) 

service name database.services(4) 

service provider implementation for pam_acct_mgmt .pam_sm_acct_mgmt(3) 

service provider implementation for pam_authenticate () .pam_sm_authenticate(3) 

service provider implementation for pam_chauthtok () .pam_sm_chauthtok(3) 

service provider implementation for pam open session () andpam ciose„session() 

.pam_sm_open_session(3) 

service provider implementation for pam_setcred() .pam_sm_setcred(3) 

service switch .service.switch(lM) 

service vt requests from other systems.vtdaemon(lM) 

service, reminder.calendar(l) 

service, switch - i ndicate lookup sources and fal I back mechanism.service.switch(lM) 

services daemon, I nternet .inetd(lM) 

services - service name database.services(4) 

session creation and termination operations, PAM .pam_open_session(3) 

session.glossary (9) 

session I D, get .getsid(2) 

session ID, get terminal .tcgetsid(3C) 

session Ieader .glossary(9) 

session lifetime.glossary (9) 

Session Manager state information, get Terminal .tsm.info(l) 

Session Manager,Terminal .tsm(l) 

session record filecreated by acctconi, print.acctsh(lM) 

session, authentication, account, and password management PAM modules for UNIX .pam_unix(5) 

session, create and set process group ID .setsid(2) 

session, record typescript of terminal output during .script(l) 

session, start terminal.login(l) 

set a process's alarm clock .alarm(2) 

set access control list (ACL) information .setacl(2) 

set access permissions mode mask for file-creation .umask(l) 

set and clear window attributes.standend(3X) 

set and get concurrency level of unbound threads .pthread_getconcurrency(3T) 

set and get current user context .getcontext(2) 

set and get the scheduling policy and associated parameters .pthread_getschedparam(3T) 

set and get the thread-specific data associated with a key.pthread_getspecific(3T) 

set and retrieve the current thread's cancelability state and type.pthread_setcancelstate(3T) 

set and/or get signal alternate stack context.sigaltstack(2) 

set and/or get signal stack context .sigstack(2) 

set attributes for pthread .pthread_attr_getdetachstate(3T) 

set audit ID (aid()) for current process .setaudid(2) 

set cchar_t from a wide character string and rendition.setcchar(3X) 

set contents of memory area to specified byte.memory(3C) 

set current ignorablesignalsmask.sigsetmask(2) 

set current signal mask.sigsetmask(2) 

set current system-dock date and time to new value.date(l) 

set environment for command execution.env(l) 

set extent attributes (VxFS) .setext(lM) 

set file access and modification times .utime(2) 

set file access and modification times .utimes(2) 


set fill byte for ELF files .elf_fill(3E) 

set foreground process group ID .tcsetpgrp(3C) 

set group access list .setgroups(2) 

set LVM volume group availability.vgchange(lM) 

set name of current host system.hostname(l) 

set name of current NIS domain .getdomainname(2) 

set name of host cpu .sethostname(2) 

set network entry .getnetent(3N) 

set network group entry.getnetgrent(3C) 

set network host entry.gethostent(3N) 

set Network Information Service domain name.domainname(l) 
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set node name.uname(l) 

set node name.uname(2) 


set of semaphores, get .semget(2) 

set or clear auditing on calling process.setaudproc(2) 

set or display audit file information .audsys(lM) 

set or get audit files .audctl(2) 

set or get background character and rendition using a complex character.bkgrnd(3X) 

set or get background character and rendition using a single-bytecharacter.bkgd(3X) 

set or get the thread process-shared attribute.pthread_condattr_getpshared(3T) 

set or get tty baud rate.cfspeed(3C) 

set printing options for a non-serial printer .slp(l) 

set process group ID for job control .setpgid(2) 

set process group ID .setpgrp(2) 

set process group ID, create session and .setsid(2) 

set process priority.getpriority(2) 

set protocol entry.getprotoent(3N) 

set real and effective user IDs .setreuid(2) 


set real, effective, and/or saved user or group IDs.setresuid(2) 

set scheduling parameters .rtsched(2) 

set scheduling policy .rtsched(2) 

set service entry .getservent(3N) 

set - set/define flags and arguments.csh(l) 

set - set/define options and arguments.ksh(l) 

set - set/define options and arguments .sh-bourne(l) 

set - set/define options and arguments.sh-posix(l) 

set signal alternate stack context .sigaltstack(2) 

set special attributes for group .getprivgrp(2) 

set system name .uname(l) 

set system name .uname(2) 

set system resource consumption limit .getrlimit(2) 

set tabs on a terminal .tabs(l) 


set terminal characteristics for cue .cuegetty(lM) 

set terminal type, modes, speed and line discipline for 2-way line .uugetty(lM) 

set terminal type, modes, speed, and line discipline.getty(lM) 

set the blocking status of a message queue associated with a descriptor.mq_setattr(2) 

set the cursor mode.curs_set(3X) 


set the default message catalog 
set the interval timer . 


setcat(3) 

ualarm(2) 


set the locale of a program . 

set the prioceiling attribute. 

set the prioceiling of a mutex .... 
set the process-shared attribute. 
set the process-shared attribute 

set the protocol attribute. 

set the spin attribute . 

set the type attribute. 

set the yield frequency attribute 
set ti me and date. 


.setlocale(3C) 

pthread_mutexattr_getprotocol(3T) 
.. pthread_mutex_getprioceiling(3T) 
pthread_mutexattr_getpshared(3T) 
pthread_rwlockattr_getpshared(3T) 
pthread_mutexattr_getprotocol(3T) 
. pthread_mutexattr_getspin_np(3T) 
pthread_mutexattr_getpshared(3T) 
. pthread_mutexattr_getspin_np(3T) 
. stime(2) 


set time limit for I/O operations.io_timeout_ctl(3l) 

set tty device operating parameters.tcattribute(3C) 

set up I/O read termination character on special file .io_eol_ctl(3l) 

set up NIS+servers.nisserver(lM) 

set user or group ID .setuid(2) 

set valueof process interval timer .getitimer(2) 

set value of system-wide clock .setclock(3C) 

set width (in bits) of data path.io_width_ctl(3l) 

set, query configuration and loadableflagsfor a module.kmsystem(lM) 

set, reset, or query system parameter .kmtune(lM) 

set-group-1 D bit.glossary(9) 

set-user-1 D bit .glossary(9) 

set: file creation (permissions) mask, set and get .umask(2) 
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set: file size limits and break value, get or set .ulimit(2) 

setacl (), fsetacl () - set access control list (ACL) information .setacl(2) 

setacientry () - add, modify, or delete access control list entry .setaclentry(3C) 

setaudid(2) - HP-UX Auditing System described .audit(5) 

setaudid() - set audit ID (aid()) for current process .setaudid(2) 

setaudproc () - set or clear auditing on calling process.setaudproc(2) 

setboot - display and modify variables in the stable storage.setboot(lM) 

setbuf (), setvbuf () - assign buffering to a stream file.setbuf(3S) 

setcato - set the default message catalog .setcat(3) 

setcchar () - set cchar_t from a wide character string and rendition .setcchar(3X) 

setciock () - set value of system-wide clock .setclock(3C) 

setcontext () - get and set current user context .getcontext(2) 

setdomainname () - set name of current NIS domain .getdomainname(2) 

setdvagent () - set device assignment databaseentry .getdvagent(3) 

setenv - defineenvironment variable.csh(l) 

setevent(2) - HP-UX Auditing System described .audit(5) 

setevent () - set current events and system callsto beaudited .setevent(2) 

setexportent () - access exported file system information .exportent(3N) 

setext - set extent attributes (VxFS) .setext(lM) 

setfsent () - open and rewind file system descriptor file.getfsent(3X) 

setgid() - set group ID .setuid(2) 

setgrent () - rewind pointer to first entry in group () file .getgrent(3C) 

setgroups () - set group access list .setgroups(2) 

sethostent () - set network host entry.gethostent(3N) 

sethostent_r () - set network host entry (thread-safe) .gethostent(3N) 

sethostname () - set name of host cpu .sethostname(2) 

setitimer() - set value of process interval ti mer .getitimer(2) 

setjmpt) - save stack environment for non-local goto .setjmp(3C) 

setkeyO - generate hashing encryption .crypt(3C) 

setkey_r() - generate hashing encryption .crypt(3C) 

setiabei () - define label for formatting routines .setlabel(3) 

setiocale () - set the locale of a program .setlocale(3C) 

setiocaie_r () - set the locale of a program (MT-Safe).setlocale(3C) 

setiogmask () - set system log file priority mask .syslog(3C) 

setmnt - establish mount table/etc/mnttab .setmnt(lM) 

setmntent () - open a file system description file .getmntent(3X) 

setnetconfig () - get /etc/netconfig entry corresponding to NETPATH component .getnetpath(3N) 

setnetconfig() - get network configuration data baseentry .getnetconfig(3N) 

setnetent (): get network entry.getnetent(3N) 

setnetgrent () - get network group entry .getnetgrent(3C) 

setpgid () - set process group ID for job control .setpgid(2) 

setpgrp() - create session and set process group ID .setsid(2) 

setpgrp() - set process group ID .setpgrp(2) 

setpgrp2 () - set process group ID for job control .setpgid(2) 

setpgrp3 () - create session and set process group ID .setsid(2) 

setprdf ent () - mani pul ate system default databaseentry .getprdfent(3) 

setpriority () - set process priority .getpriority(2) 

setprivgrp - set special privileges for group .setprivgrp(lM) 

setprivgrpO - set special attributesfor group .getprivgrp(2) 

setprotoent () - set protocol entry.getprotoent(3N) 

setprotoent_r () - set protocol entry (thread-safe) .getprotoent(3N) 

setprpwent () - set protected password databaseentry .getprpwent(3) 

setprtcent () - manipulateterminal control databaseentry .getprtcent(3) 

setpwent () - rewind pointer to beginningof password file .getpwent(3C) 

setresgid() - set real, effective, and/or saved group IDs.setresuid(2) 

setresuid() - set real, effective, and/or saved user IDs.setresuid(2) 

setriimit () - set system resource consumption limit .getrlimit(2) 

setriimit64 () - file system API to support large files.creat64(2) 

setscrregt) - terminal output control functions.clearok(3X) 

setservent() - set service entry .getservent(3N) 

setservent_r () - set service entry (thread-safe).getservent(3N) 
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setsid() - createsession and set process group ID .setsid(2) 

setsockopt () - set options on sockets.getsockopt(2) 

setspent () - rewind pointer to beginning of secure password file.getspent(3C) 

setspwent () - rewind pointer to beginning of secure password file.getspwent(3X) 

setstate (), random(), srandom(), initstate () - generate a pseudorandom number .random(3M) 

settings, terminal, and datacomm line speed used by getty .gettydefs(4) 

setuid() - set user ID .setuid(2) 

setuname - change machine information .setuname(lM) 

setuname() - set node name (system name) .uname(2) 

setup, audio.see audio(5) 

setupterm() - interface to terminfo database.del_curterm(3X) 

setusersheii () - rewind legal user shellsfile.getusershell(3C) 

setutento - reset input stream to beginning of utmp () file.getut(3C) 

setutent_r() - reset input stream to beginning of utmp () file.getut(3C) 

setutxent () - reset input stream to beginning of utmpx () file.getutx(3C) 

set_curterm() - interface to terminfo database.del_curterm(3X) 

set_parms special initialization script.hostname(l) 

set_term () - switch between screens .set_term(3X) 

severities, define additional .addsev(3C) 

sh - overview of various system shells .sh(l) 

sh - shell based on POSIX.2.sh-posix(l) 

sh - shell, the standard command programming language.sh-bourne(l) 

shar - make a shell archive package.shar(l) 

shared cache file, NlS+utility to print out the contents of.nisshowcache(lM) 

shared libraries programs, prepare for faster program start-up.fastbind(l) 

shared libraries, generate from object files .Id(l) 

shared library. glossary(9) 

shared library loaded module.dlget(3C) 

shared library loaded module.dlmodinfo(3C) 

shared library, list dynamic dependencies of shared libraries .Idd(l) 

shared library, load or unload .shl_load(3X) 

shared library, lock in memory.plock(2) 

shared library, look up symbol in .shl_load(3X) 

shared memory and data segment, attach or detach .shmop(2) 

shared memory control operations .shmctl(2) 

shared memory identifier (shmid).glossary(9) 

shared memory identifier, remove .ipcrm(l) 

shared memory operation permissions.glossary(9) 

shared memory segment, get.shmget(2) 

shared memory segments, report status .ipcs(l) 

shared object, close.dlclose(3C) 

shared object, get address of symbol .dlsym(3C) 

shared object, open .dlopen(3C) 

shared strings, extract strings from C programs to implement.xstr(l) 

shear characters from beginning of line and move to end of line.newform(l) 

shell (command interpreter) with C-likesyntax .csh(l) 

shell archive package, make a.shar(l) 

shell command, issue a .system(3S) 

shell environment variable.login(l) 

shell .glossary(9) 

shell layer manager .shl(l) 

shell procedures for system accounting.acctsh(lM) 

shell program . glossary(9) 

shell script.glossary(9) 

shell script to set up user's environment at login .profile(4) 

shell server, remote.remshd(lM) 

shell, Bourne.sh-bourne(l) 

shell, context-sensitive softkey.keysh(l) 

shell, login, change default.chsh(l) 

shell, remote, execute from a .remsh(l) 

shell, restricted shell for sendmail .smrsh(lM) 
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shells - list of allowed login shells .shells(4) 

shells, get legal user.getusershell(3C) 

shells, list of allowed login .shells(4) 

shells, overview of various system.sh(l) 

shift - shift argv members one position to left .csh(l) 

shift - shift argv members one position to left.ksh(l) 

shift - shift argv members one position to left.sh-posix(l) 

shift - shift positional parameters to next lower position .sh-bourne(l) 

shi - shell layer manager .shl(l) 

shi findsym() - look up symbol in shared library .shl_load(3X) 

shi get () - get information about shared library.shl_load(3X) 

shi_ioad() - load shared library.shl_load(3X) 

shi unioad() - unload shared library.shl_load(3X) 

shmat () - attach shared memory to data segment.shmop(2) 

shmcti () - shared memory control operations .shmctl(2) 

shmdt () - detach shared memory from data segment .shmop(2) 

shmget () - get shared memory segment.shmget(2) 

shmid (shared memory identifier).glossary(9) 

shm open () - creat^open a shared memory object .shm_open(2) 

shm unlink () - unlink a shard memory object.shm_unlink(2) 

shortest path and route between hosts, compute.pathalias(l) 

show all remote mounts .showmount(lM) 

show current system-dock dateand time.date(l) 

show disk usage .du(l) 

show FDDI interface status.fddistat(lM) 

show Fibre Channel Lightweight Protocol network status.Iwpstat(lM) 

show file differences side-by-side.sdiff(l) 

show group memberships.groups(l) 

show how long system has been up.uptime(l) 

show network status.netstat(l) 

show PCI FDDI interface status.fddipciadmin(lM) 

show STREAMS structures.strdb(lM) 

show who is logged in on local machines .rwho(l) 

showmount - show all remote mounts .showmount(lM) 

shut down a socket .shutdown(2) 

shut down and reboot the system .reboot(lM) 

shutacct - turn off accounting for system shutdown .acctsh(lM) 

shutdown statusof specified filesystem, determine.fsclean(lM) 

shutdown - terminateall processing .shutdown(lM) 

shutdown () - shut down a socket .shutdown(2) 

shutdown, system, turn accounting off for .acctsh(lM) 

shutdown, test for filesystem clean at last .fsciean(lM) 

sigaction() - exami ne and change signal action .sigaction(2) 

sigaddset () - initialize, manipulate, and test signal sets.sigsetops(3C) 

sigaitstack () - set and/or get signal alternate stack context.sigaltstack(2) 

sigblock () - block signals.sigblock(2) 

sigdeiset () - initialize, manipulate, and test signal sets.sigsetops(3C) 

sigemptyset () - initialize, manipulate, and test signal sets.sigsetops(3C) 

sigfiliset () - initialize, manipulate, and test signal sets.sigsetops(3C) 

sighoid(), sigreise(), sigignore() - signal management .sighold(2V) 

sighoid () - signal management .signal(2) 

sigignore(), sighoid(), sigreise() - signal management .sighold(2V) 

sigignore() - signal management .signal(2) 

siginterrupt () - allow signalsto interrupt functions.siginterrupt(2) 

sigismember () - initialize, manipulate, and test signal sets.sigsetops(3C) 

sign on .login(l) 

sign-determination macro, floating-point .signbit(3M) 

signal action, examine and change .sigaction(2) 

signal action, examine and change.sigwait(2) 

signal alternate stack context, set and/or get.sigaltstack(2) 

signal - description of signals.signal(5) 
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signal facilities. 

signal facilities, software. 

signal . 

Signal management (sighold(), sigrelse(), sigignoreO) . 

Signal management (sigset (), sighold(), sigrelse(), sigignore(), sigpause()) 

signal mask, examine and change, of thecallingthread . 

signal sets, initialize, manipulate, and test . 

signal stack context, set and/or get . 

signal stack space, define, delete, or get amount of. 

signal to a thread, send . 

signal to process. 

signal () - 4.2 BSD-compatible signal () system call . 

signal () - specify what to do upon receipt of a signal . 

signal () system call, 4.2 BSD-compatible. 

signal () system call, 4.2 BSD-compatible . 

signal, audible. 

signal, define what to do upon receipt of a . 

signal, hold upon receipt . 

signal, hold upon receipt. 

signal, ignore. 

signal, ignore. 

signal, raise a software. 

signal, restore action . 

signal, restore action . 

signal, select method of handling. 

signal, select method of handling. 

signal, send to a process or a group of processes . 

signal, send to process or group of processes . 

signal, suspend calling process until received. 

signal, suspend calling process until received . 

signal, suspend process until. 

signal, wait for a. 

signal.h - description of signals. 

signalsallowed to interrupt functions. 

signals mask, set current ignorable. 

signals, block . 

signals, blocked, examine and change . 

signals, description of . 

signals, examine pending. 

signals, release blocked and atomically wait for interrupt . 

signals, send to domain name server . 

signbito - floating-point sign-determination macro . 

signgam(), gamma (), lgamma(), Igamma r () - log gamma function . 

sigpause () - atomical ly release blocked signals and wait for interrupt . 

sigpending () - examine pending signals. 

sigprocmask () - examine and change blocked signals . 

sigqueue () - queue a signal to a process . 

sigreise(), sigignore(), sighoid() - signal management . 

sigreise () - signal management . 

sigsend() - send a signal to a process. 

sigsendset () - send a signal to a group of processes. 

sigset (), sighold (), sigreise (), sigignore (), sigpause () - Signal management 

sigset () - signal management . 

sigset jmp () - save signal mask if savemask is non-zero . 

sigsetmask() - set current signal mask . 

sigspace () - define or delete additional signal stack space. 

sigstack() - set and/or get signal stack context . 

sigsuspend() - wait for a signal . 

sigtimedwait () - synchronously accept a signal . 

sigvec () - 4.2 BSD-compatible sigvec () system call . 

sigvec () system call, 4.2 BSD-compatible. 


Entry Name(Section) 

.bsd_signal(3C) 

.sigvector(2) 

.glossary (9) 

.sighold(2V) 

.sigset(3C) 

pthread_sigmask(3T) 

.sigsetops(3C) 

.sigstack(2) 

.sigspace(2) 

.pthread_kill(3T) 

.kill(l) 

killpg(2) 

.signal (2) 

.bsdproc(3C) 

ki 11 pg{2) 

.beep(3X) 

.signal (2) 

.sighold(2V) 

.sigset(3C) 

. sighold(2V) 

.sigset(3C) 

.ssignal(3C) 

.sighold(2V) 

.sigset(3C) 

.sighold(2V) 

.sigset(3C) 

.sigsend(2) 

.kill (2) 

.sighold(2V) 

.sigset(3C) 

.pause(2) 

.sigsuspend(2) 

.signal (5) 

.siginterrupt(2) 

.sigsetmask(2) 

. sigblock(2) 

.sigprocmask(2) 

.signal (5) 

.sigpending(2) 

.sigpause(2) 

.signamed(lM) 

.signbit(3M) 

.lgamma(3M) 

.sigpause(2) 

.sigpending(2) 

.sigprocmask(2) 

.sigqueue(2) 

.sighold(2V) 

.signal (2) 

.sigsend(2) 

.sigsend(2) 

.sigset(3C) 

.signal (2) 

.setjmp(3C) 

.sigsetmask(2) 

.sigspace(2) 

.sigstack(2) 

.sigsuspend(2) 

.sigwait(2) 

ki 11 pg( 2} 
.bsdproc(3C) 
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sigvec () system call, 4.2 BSD-compatible .killpg(2) 

sigvector () - software signal facilities.sigvector(2) 

sigwait () - synchronously accept a signal .sigwait(2) 

sigwaitinfo () - synchronously accept a signal .sigwait(2) 

sig named - send signalsto domain name server .sig named(lM) 

simple command, execute a.command(l) 

simple text formatter .fmt(l) 

simplified signal facilities.bsd_signal(3C) 

sin() - sinefunction.sin(3M) 

sind() - sinefunction (degrees) .sind(3M) 

sindf () - sinefunction (float, degrees).sind(3M) 

sinefunction (degrees) .sind(3M) 

sinefunction, inverse hyperbolic .asinh(3M) 

sinefunctions .sin(3M) 

sine functions, hyperbolic.sinh(3M) 

sinf() - sinefunction (float).sin(3M) 

single-byte character and rendition, add, to a window and advance the cursor.addch(3X) 

single-byte character and rendition, echo to a window and refresh .echochar(3X) 

single-byte character and rendition, input from a window.inch(3X) 

single-byte character and rendition, insert into a window.insch(3X) 

single-byte character, get from the terminal .getch(3X) 

single-byte character, set or get background character or rendition, using.bkgd(3X) 

single-byte characters and renditions to a window, add length limited string of.addchnstr(3X) 

single-byte characters and renditions to a window, add string of.addchstr(3X) 

single-byte characters and renditions, array of, input from a window .inchnstr(3X) 

single-byte characters and renditions, draw borders .border(3X) 

single-byte characters and renditions, draw borders.box(3X) 

single-byte characters and renditions, draw lines from .hline(3X) 

single-byte terminal environment query functions.erasechar(3X) 

single-user mode . init(lM) 

single-user mode, place system in.shutdown(lM) 

single-user state .glossary(9) 

sinh (), sinhf () - hyperbolic sinefunctions.sinh(3M) 

sinhf (), sinh () - hyperbolic sinefunctions.sinh(3M) 

sis - secure internet services description.sis(5) 

sixteen-bit characters, tools to process.nl_tools_16(3X) 

size information of screen, specify source.use_env(3X) 

size of file in words, lines, and bytes or characters .wc(l) 

size - print section sizes and allocation space of object files.size(l) 

size, extend filesystem .extendfs(lM) 

size, extend HFS filesystem .extendfs_hfs(lM) 

size, extend VxFS filesystem .extendfs_vxfs(lM) 

size, return for elf32 or elf64 fiIes .elf_fsize(3E) 

slash.glossary(9) 

slave (pseudo-terminal) driver, STREAMS.tels(7) 

slave and master pty, STREAMS, unlocking.unlockpt(3C) 

slavepty (pseudo-terminal) driver, STREAMS .pts(7) 

slave pty, get the name of a .ptsname(3C) 

slave pty, STREAMS, granting access .grantpt(3C) 

sleep - suspend execution for a time interval.sleep(l) 

sleep () - suspend execution for interval .sleep(3C) 

sleep, high resolution .nanosleep(2) 

sik attroff () - soft label functions.slk_attroff(3X) 

sik attron () - soft label functions.slk_attroff(3X) 

sik attrset () - soft label functions.slk_attroff(3X) 

slk_attr_off () - soft label functions.slk_attroff(3X) 

sik_attr_on() - soft label functions.slk_attroff(3X) 

sik_attr_set () - soft label functions.slk_attroff(3X) 

sik__ciear () - soft label functions.slk_attroff(3X) 

slk_color () - soft label functions.slk_attroff(3X) 

slk init () - soft label functions.slk_attroff(3X) 
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slk_label () - soft label functions.slk_attroff(3X) 

slk noutrefresh () - soft label functions.sik_attroff(3X) 

sik refresh () - soft label functions.slk_attroff(3X) 

sik restore () - soft label functions.slk_attroff(3X) 

sik set () - soft label functions.slk_attroff(3X) 

sikjtouch() - soft label functions.slk_attroff(3X) 

sik wset () - soft label functions.slk_attroff(3X) 

slot in theutmpO file of the current user, find .ttyslot(3C) 

sip - set printing options for a non-serial printer .slp(l) 

sm - statd directory and file structures.sm(4) 

sm.bak - statd directory and file structures.sm(4) 

Small Computer System Interface (SCSI) device drivers .scsi(7) 

Smart Card Login .login(l) 

smrsh - restricted shell for sendmail.smrsh(lM) 

sna3l79g, sna3270, sna3770 - IBM 3179G/3192G, 3270, 3777terminal emulator.sna(l) 

snapshot of the UUCP system.uusnap(lM) 

SNMP agent, configuration filefor the.snmpd.conf(4) 

SNMP requests, daemon that responds to.snmpd(lM) 

snmpd - daemon that responds to SNMP requests.snmpd(lM) 

snmpd.conf - configuration filefor theSNMP agent .snmpd.conf(4) 

snprintf () - print formatted output to a string .printf(3S) 

socket address, get .getsockname(2) 

socket - Interprocess communications.socket(7) 

socket () - create an endpoint for communication .socket(2) 

socket, accept connection on a.accept(2) 

socket, bi nd address to a .bind(2) 

socket, bind to a privileged IP port .bindresvport(3N) 

socket, initiateconnection .connect(2) 

socket, listen for connections on a .listen(2) 

socket, receive message from a.recv(2) 

socket, return a reserved port .rcmd(3N) 

socket, send message to a .send(2) 

socket, send the contents of a file through a socket.sendfile(2) 

socket, shut down a .shutdown(2) 

socketpair () - create a pair of connected sockets.socketpair(2) 

sockets, create a pair of connected .socketpair(2) 

sockets, get or set options.getsockopt(2) 

soelim - eliminate .so's from nroff input.soelim(l) 

soft (symbolic) file link .symlink(4) 

soft label functions.slk_attroff(3X) 

soft-copy terminals, peruse file on .more(l) 

soft-copy terminals, peruse file on.pg(l) 

softbench - SoftBench Software Development Environment.softbench(l) 

SoftBench Software Development Environment.softbench(l) 

softkey file format for keysh .softkeys(4) 

softkey shell, context-sensitive.keysh(l) 

softkeys - keysh softkey file format .softkeys(4) 

softpower - determine if softpower hardware is installed.softpower(lM) 

softpower hardware.softpower(lM) 

Software Development Environment, SoftBench .softbench (1) 

Software Distributor agent on remote systems .pushAgent(lM) 

software products, display information about .swlist(lM) 

software products, install, configure, and copy .swinstall(lM) 

software products, modify in target root or depot.swmodify(lM) 

software products, package into target depot or tape.swpackage(lM) 

software products, remove and unconfigure .swremove(lM) 

software products, verify .swverify(lM) 

software signal facilities.sigvector(2) 

software signal, raisea.ssignal(3C) 

software signal, send to process or group of processes.ki 11 (2) 

software, outbound connection daemon debug utility used by DDFA .ocdebug(lM) 
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solidus.glossary(9) 

sort a directory pointer array .scandir(3C) 

sort and embellish uusnap output.uusnaps(lM) 

sort and/or merge files .sort(l) 

sort - sort and/or merge files .sort(l) 

sort, quicker.qsort(3C) 

sort, topological .tsort(l) 

sorted files, reject/select lines common to two.comm(l) 

sorted tables, binary search routine for.bsearch(3C) 

Source Code Control System (SCCS) .glossary(9) 

Source Code Control System .see SCCS 

source code.glossary(9) 

source - define source for command input .csh(l) 

source of screen size information, specify.use_env(3X) 

source program files for given name, find location of .whereis(l) 

source, C, extract error messages from into a file .mkstr(l) 

space allocation, change data segment .brk(2) 

space for LVM logical volume, increase.Ivextend(lM) 

space for signal stack, define, delete, or get amount of .sigspace(2) 

space information, system paging .swapinfo(lM) 

space, recover disk .freedisk(lM) 

space, stack and data, allocatethen lock process into memory.datalock(3C) 

spaces, convert to tabs and vice versa.expand(l) 

spawn getty to remote terminal (call terminal).ct(l) 

spawn new process (use fork () instead).vfork(2) 

spawn processes .init(lM) 

spd - set physical drive parameters for an HP SCSI disk array.spd(lM) 

special (device) file, make.mksf(lM) 

special (device) file, remove a.rmsf(lM) 

special (device) files, install .insf(lM) 

special (I/O device) file, list a .Issf(lM) 

special and FIFO files, create.mknod(lM) 

special attributesfor group, get.getprivgrp(l) 

special file .glossary(9) 

special file, control character device .ioctl(2) 

special file, FIFO, make a.mkfifo(3C) 

special file, make .mknod(2) 

special file, set up I/O read termination character on .io_eol_ctl(3l) 

special files, introduction.intro(7) 

special files, make FIFO (named pipe) .mkfifo(l) 

special files: cartridge tape device.ct(7) 

special files: general terminal interface .termio(7) 

special files: HP-HIL cooked keyboard driver .hilkbd(7) 

special files: HP-HIL device driver .hil(7) 

special files: lineprinter device files.Ip(7) 

special files: pseudo-terminal driver .pty(7) 

special files: system console interface.console(7) 

special files: terminal interface device file, process-controlling .tty(7) 

special files: Version 6/PWB-compatibile terminal interface.sttyv6(7) 

special files; list all device drivers available in the system .Isdev(lM) 

special functions of HP 2640- and HP 2621-series terminals, handle.hp(l) 

special initialization script, /sbin/set_parms.hostname(l) 

special processes.glossary(9) 

specific Network I nformation Service server, bind to a.ypset(lM) 

specific ti me i nterval tothecurrent absolute system time, add a .get_expiration_time(3T) 

specification, format, in text files .fspec(4) 

specified remote machines, write to .rwall(3N) 

specify I/O read termination character on special file.io_eol_ctl(3l) 

specify source of screen size information.use_env(3X) 

specify what to do upon receipt of a signal .signal(2) 

speed, datacomm line, and terminal settings used by getty .gettydefs(4) 
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speed, inform system of required minimum I/O transfer .io_speed_ctl(3l) 

spell - find spelling errors .spell(l) 

speilin - convert 9-digit hash codes to compressed spelling reference list.spell(l) 

spelling errors, find.spell(l) 

spin attribute, get or set .pthread_mutexattr_getspin_np(3T) 

split a file into multipie n-line pieces.split(l) 

split buffer into fields.bufsplit(3G) 

split file into multiplefiles.csplit(l) 

split mirrored LVM logical volume into two logical volumes.Ivsplit(lM) 

split - split a file into multi pie n-line pieces.split(l) 

spool directory clean-up, uucp .uuclean(lM) 

spool directory clean-up, uucp.uucleanup(lM) 

spooled uucp transactions grouped by transaction, list .uuls(lM) 

spooler performance analysis information, print LP .Ipana(lM) 

spooling.see printer 

spooling system, configure the LP .Ipadmin(lM) 

spool ing system, Ii ne pri nter .see L P 

spray: scatter data to check the network.spray(3N) 

spray packets.spray(lM) 

spray server.sprayd(lM) 

spray - spray packets.spray(lM) 

sprayd - spray server .sprayd(lM) 

sprintf () - print formatted output to a string .printf(3S) 

sqrt () sqrtf () - square root functions.sqrt(3M) 

sqrtf (), sqrt () - square root functions.sqrt(3M) 

square root functions.sqrt(3M) 

srand() - reset random-number generator to random starting point .rand(3C) 

srand48 (), seed48 (), icong48 () - initializepseudo-random number generator .drand48(3C) 

srandom(), initstate (), setstate (), random() - generate a pseudorandom number .random(3M) 

SRQ line on HP-IB, allow interface to enable.hpib_rqst_srvce(3l) 

SS/80.glossary(9) 

sscanf () - formatted read from character string .scanf(3S) 

ssignai () - raise a software signal and perform an action .ssignal(3C) 

ssp - remove multiple line-feeds from output.ssp(l) 

ssrfc - SCSI surface device access.autochanger(7) 

sss - set spindlesynchronization state of drives in an HP SCSI disk array .sss(lM) 

stable storage, display and modify variables in.setboot(lM) 

stack and data space, allocate then lock process into memory.datalock(3C) 

stack context, set/get signal alternate stack context .sigaltstack(2) 

stack context, signal, set and/or get .sigstack(2) 

stack environment, sav^restorefor non-local goto.setjmp(3C) 

stack space for signals, define, delete, or get amount of.sigspace(2) 

stack, lock in memory.plock(2) 

stacksize, change default.pthread_default_stacksize_np(3T) 

stale logical volume mirrors in LVM volume groups, synchronize .vgsync(lM) 

stale mirrors in LVM logical volumes, synchronize .Ivsync(lM) 

standard buffered input/output stream file package.stdio(3S) 

standard error and console, displays formatted message on .fmtmsg(3C) 

standard error .glossary(9) 

standard format, display message in .pfmt(3C) 

standard input.glossary(9) 

standard input stream, input string from a.gets(3S) 

standard input to system log, send.logger(l) 

standard input, read a line from .read(l) 

standard output.glossary(9) 

standard output, send copy of to specified file.tee(l) 

standard structures and symbolic constants.unistd(5) 

standend() - set and dear window attributes.standend(3X) 

standout () - set and clear window attributes.standend(3X) 

stape, magnetic tape interface for tapel, tape2, and.mt(7) 

start accounting process at system startup .acctsh(lM) 
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start license server .i4lmd(lM) 

start of file, list first few lines at.head(l) 

start or halt auditing system.audctl(2) 

start or halt auditing system .audsys(lM) 

start terminal session.login(l) 

start the Virtual Home Environment (VHE) .vhe_mounter(lM) 

start/stop the LP spooling request scheduler .Ipsched(lM) 

startup - start accounting process at system startup.acctsh(lM) 

startup, system, start accounting process at .acctsh(lM) 

start color () - color manipulation functions.can_change_coior(3X) 

stat/fstat/istat system call, data returned by .stat(5) 

stat - data returned by stat/fstat/istat system call .stat(5) 

stat () - get file status .stat(2) 

stat64 () - file system API to support large files.creat64(2) 

statd directory and file structures .sm(4) 

statd - network status monitor .statd(lM) 

state information, get Terminal Session Manager .tsm.info(l) 

state - statd directory and file structures.sm(4) 

state with its state on disk, synchronize a file's in-core.fsync(2) 

state, PAM routines to maintain module specific state.pam_set_data(3) 

statfs (), fstatfs () - get file system statistics .statfs(2) 

statfsdev(), fstatfsdev() - get filesystem statistics.statfsdev(3C) 

static file system mounting table.pfs_fstab(5) 

static information about the file systems .fstab(4) 

station address string conversion routines, network .net_aton(3C) 

statistics for filesystem, list (generic).ff(lM) 

statistics for HFS filesystem, list file names and .ff_hfs(lM) 

statistics for VxFS filesystem.ff_vxfs(lM) 

statistics server, kernel .rstatd(lM) 

statistics, get filesystem .statfs(2) 

statistics, get filesystem.statfsdev(3C) 

statistics, get filesystem.statvfsdev(3C) 

statistics, get mounted filesystem.ustat(2) 

statistics, local filesystem mount .rmtab(4) 

statistics, Network FileSystem .nfsstat(lM) 

statistics, print mail traffic.mailstats(l) 

statistics, report I/O .iostat(l) 

statistics, report NIS+server.nisstat(lM) 

statistics, report virtual memory .vmstat(l) 

status condition becomes true, wait until the requested .hpib_status_wait(3l) 

status information and attributes associated with a message queue, get .mq_getattr(2) 

status information, LP request, print .Ipstat(l) 

status inquiries, stream .ferror(3S) 

status inquiry and job control, uucp .uustat(l) 

status lines of GP10 card, return .gpio_get_status(3l) 

status monitor, network.statd (1M) 

status of HP-1 B interface, return .hpib_bus_status(3l) 

status of interprocess communication facilities, report .ipcs(l) 

status of local machines, show .ruptime(l) 

status server, system .rwhod(lM) 

status show network .netstat(l) 

status, asynchronous I/O error .aio_error(2) 

status, audit, of event or system call, change or display.audevent(lM) 

status, current, of the UUCP system .uusnap(lM) 

status, display LAN device configuration and .lanscan(lM) 

status, exit, do nothing and return zero or non-zero .true(l) 

status, get file.stat(2) 

status, get file status.fstat(2) 

status, get file.statvfs(2) 

status, get symbolic link.Istat(2) 

status, host, of local machines (RPC version), show .rup(l) 
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status, line update status functions.redrawwin(3X) 

status, report process.ps(l) 

status, show FDDI interface.fddistat(lM) 

status, show FibreChannel Lightweight Protocol network .Iwpstat(lM) 

status, show PCI FDDI interface.fddipciadmin(lM) 

status: LP requests sent to remote system for printing .rlpstat(lM) 

statvfs (), fstatvfs () - get file status .statvfs(2) 

statvfs64() - file system API to support large files.creat64(2) 

statvfsdev(), fstatvfsdev() - get filesystem statistics.statvfsdev(3C) 

statvfsdev64 () - file system API to support large files .fgetpos64(2) 

stdarg.h - macros for handling variableargument list.stdarg(5) 

stderr .glossary(9) 

stdin .glossary(9) 

stdio () - standard buffered input/output stream file package .stdio(3S) 

stdout .glossary(9) 

stdscr () - default window .stdscr(3X) 

stdsyms - description of PIP-UX header file organization.stdsyms(5) 

step() - regular expression string comparison routine.regexp(3X) 

sticky bit .glossary(9) 

stime () - set time and date.stime(2) 

stop activity on specified HP-l B .hpib_abort(3l) 

stop and reset FDDI interface .fddistop(lM) 

stop servers.pdshutdown(l) 

stop system operation.shutdown(lM) 

stop then reboot the system .reboot(lM) 

stop, wait for child process to .wait(2) 

stop/start the LP spooling request scheduler .Ipsched(lM) 

stops printers from accepting jobs and logs from logging.pddisable(l) 

storage associated with a screen .delscreen(3X) 

storage formats, attributes, and objects for SD .sd(4) 

storage, preallocate disk .prealloc(l) 

storage, preallocate fast disk.prealloc(2) 

storage, stable, display and modify variables in .setboot(lM) 

store () - store data under a key (old single-data-base version) .dbm(3X) 

strace - write STREAMS event trace messages to standard output .strace(lM) 

strcasecmpO , strncasecmp () - compare two strings.string(3C) 

strcat (), strncat () - append string 2 to string 1.string(3C) 

strchg - change or query stream configuration.strchg(lM) 

strchr (), strrchr () - get pointer to character in string .string(3C) 

strclean - remove outdated STREAMS error log files .strclean(lM) 

strcmp (), strncmp () - compare two strings.string(3C) 

strcoii () - process string of text tokens .string(3C) 

strconf - query stream configuration.strchg(lM) 

strcpy (), strncpy () - copy string 2 to string 1 .string(3C) 

strcspn (), strspn () - find length of matching substrings.string(3C) 

strdb - STREAMS debugging tool .strdb(lM) 

strdupt) - determine length of a string.string(3C) 

stream configuration, change or query.strchg(lM) 

stream creation, library routines for external data representation.xdr_create(3N) 

stream file or character string, read from with formatted input conversion .scanf(3S) 

stream file package, standard buffered input/output.stdio(3S) 

stream file, assign buffering to a .setbuf(3S) 

stream file, buffered binary input/output to a .fread(3S) 

stream file, get character or data word from a .getc(3S) 

stream file, get or reposition pointer for I/O operations on a .fseek(3S) 

stream file, get wide character from a .getwc(3C) 

stream file, input wide string from a .fgetws(3C) 

stream file, open or re-open; convert file to stream .fopen(3S) 

stream.glossary(9) 

stream pointer, map to file descriptor .fileno(3S) 

stream status inquiries .ferror(3S) 
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stream() - STREAMS enhancements to standard system calls.stream(2) 

stream, close a.fclose(3S) 

stream, flush buffer with or without closing.fclose(3S) 

stream, input string from a standard input.gets(3S) 

stream, push character back into input.ungetc(3S) 

stream, push wide character back into input .ungetwc(3C) 

stream, put wide character on a .putwc(3C) 

stream, put word or character on a .putc(3S) 

stream, read up to next delimiter .bgets(3G) 

stream, return to a remote command.rcmd(3N) 

stream, return to a remote command .rexec(3N) 

stream, save or restore file position indicator for a.fgetpos(3S) 

streaming text editor .sed(l) 

streamio - STREAMS ioctl commands .streamio(7) 

STREAMS Administrative Driver .sad (7) 

STREAMS debugging tool .strdb(lM) 

STREAMS enhancements to system calls .stream(2) 

STREAMS error log files, remove outdated files.strclean(lM) 

STREAMS event trace messages to standard output, write.strace(lM) 

STREAMS file descriptor .fattach(3C) 

STREAMS file, receive next message.getmsg(2) 

STREAMS ioctl commands .streamio(7) 

STREAMS log driver .strlog(7) 

STREAMS log driver, receive error messages .strerr(lM) 

STREAMS master pty (pseudo-terminal) driver.ptm(7) 

STREAMS modulefor converting ioctl () calls into Transport I nterface messages .timod(7) 

STREAMS modulefor reads and writes by Transport Interface.tirdwr(7) 

STREAMS module, terminal linediscipline.Idterm(7) 

STREAMS modules, manage system database of automatically pushed STREAMS modules .autopush(lM) 

STREAMS passthrough device driver to open a major and minor device pair on a STREAMS driver.clone(7) 

STREAMS pty (pseudo-terminal) Emulation module.ptem(7) 

STREAMS pty master/slave pair, unlocking.unlockpt(3C) 

STREAMSpty, get the name of a slave.ptsname(3C) 

STREAMS pty, Packet Mode module.pckt(7) 

STREAMS slave pty driver.pts(7) 

STREAMS slave pty, granting access to .grantpt(3C) 

STREAMS structures show .strdb(lM) 

STREAMS system calls.stream(2) 

STREAMS Telnet slave driver .tels(7) 

STREAMS terminal linediscipline module.Idterm(7) 

STREAMS verification tool .strvf(lM) 

streams within a multi-thread application, explicit locking of.flockfile(3S) 

STREAMS, change or query stream configuration .strchg(lM) 

streams, directory, format of.dirent(5) 

streams, HP-UX directory, format of.ndir(5) 

STREAMS, send a message on a stream .putmsg(2) 

STREAMS-based file descriptor .fdetach(lM) 

STREAMS-based file descriptor.fdetach(3C) 

STREAMS-based pipe .isastream(3C) 

STREAMS: attach a STREAMS file descriptor .fattach(3C) 

STREAMS: detach a name from a STREAMS-based file descriptor .fdetach(3C) 

STREAMS: detach a STREAMS-based file descriptor .fdetach(lM) 

STREAMS: determine if file descriptor refers to STREAMS device or STREAMS-based pipe.isastream(3C) 

strerr - receive error messages from the STREAMS log driver .strerr(lM) 

strerror () - system error messages.perror(3C) 

strfmon () - convert monetary valueto string.strfmon(3C) 

strftime () - convert date and ti me to string .strftime(3C) 

string conversion routines, network station address.net_aton(3C) 

string data order, convert.strord(3C) 

string form, convert access control list (ACL) structure to.acltostr(3C) 

string from a standard input stream, input.gets(3S) 
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string of single-byte characters and renditions to a window, add .addchstr(3X) 

string of wide characters, input from a window.innwstr(3X) 

string of wide-character, insert into a window.ins_nwstr(3X) 

string operations, character .string(3C) 

string operations, wide character .wcstring(3C) 

string or expression, search a filefor a.grep(l) 

string or string array element, convert floating-point number to.ecvt(3C) 

string pointer for ELF files, make.elf_strptr(3E) 

string to double-precision number, convert .strtod(3C) 

stringto long integer, convert.strtol(3C) 

string, convert between long integer and base-64 ASCI I .a64l(3C) 

string, convert dateand time to.ctime(3C) 

string, convert dateand time to .strftime(3C) 

string, convert dateand time to wide-character.wcsftime(3C) 

string, convert long doublefloating-point number to.ldcvt(3C) 

string, convert long integer to.ltostr(3C) 

string, convert monetary value to.strfmon(3C) 

string, convert to access control list (ACL) structure.strtoacl(3C) 

string, convert to long double-precision number.strtold(3C) 

string, get a multi-byte character length limited stringfrom theterminal .getnstr(3X) 

string, get a multi-byte character stringfrom theterminal .getstr(3X) 

string, parse suboptions from a .getsubopt(3C) 

string-to-NaN conversion function.nan(3M) 

string-valued configuration values, get.confstr(3C) 

strings and characters conversions, multibyte.multibyte(3C) 

strings - find the printable strings in an object, or other binary, file .strings(l) 

strings, concatenate two .string(3C) 

strings, find for inclusion in message catalogs .findstr(l) 

strings: extract strings from C programs to implement shared strings.xstr(l) 

strip nroff/troff, tbl, and neqn constructs from a file.deroff(l) 

strip - strip symbol and linenumber information from an object file.strip(l) 

strip symbol and linenumber information from an object file .strip(l) 

stripeLVM logical volume .Ivextend(lM) 

strien () - determine length of a string.string(3C) 

strlog - STREAMS log driver .strlog(7) 

strord() - convert string data order.strord(3C) 

strpbrk () - find occurrence of character from string 2 in string 1.string(3C) 

strptime() date and time conversion.strptime(3C) 

strrstr () - process string of text tokens .string(3C) 

strspn (), strcspn () - find length of matching substrings.string(3C) 

strstr() - process string of text tokens .string(3C) 

strtoaci () - convert stringto access control list (ACL) structure.strtoacl(3C) 

strtoacipatt () - convert string to access control list (ACL) structure.strtoacl(3C) 

strtod() - convert string to double-precision number .strtod(3C) 

strtok () - process string of text tokens .string(3C) 

strtok_r() - process string of text tokens .string(3C) 

strtoi () - convert stringto long integer.strtol(3C) 

strtoid () - convert string to long double-precision number .strtold(3C) 

strtoul () - convert stringto long integer.strtol(3C) 

structure format, symbol table.nlist(4) 

structure, Network Information Servicedatabaseand directory.ypfiles(4) 

structures and symbolic constants, standard.unistd(5) 

structures show STREAMS .strdb(lM) 

structures, statd directory and file.sm(4) 

strvf - STREAMS verification tool .strvf(lM) 

strxfrm () - process string of text tokens .string(3C) 

stty - set the options for a terminal port .stty(l) 

stty - terminal interface for Version 6/PWB compatibility.sttyv6(7) 

stty() - control terminal device (Bell Version 6 compatibility) .stty(2) 

su - switch user .su(l) 

subdirectories in directory, list.Is(l) 
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subdirectory .glossary(9) 

submits print jobs. pdpr(l) 

suboptions, parse from a string .getsubopt(3C) 

subordinate directory .glossary(9) 

subpad() - enhanced pad management function .subpad(3X) 

subroutine cal I graph execution profile data, display.gprof(l) 

subroutines and libraries, introduction.intro(3) 

subroutines, database (new multiple database version).ndbm(3X) 

subroutines, database (old version - see also ndbm(3X)).dbm(3X) 

subroutines, NIS+.nis_subr(3N) 

Subset 1980 .glossary (9) 

substitute selected characters.tr(l) 

subwin () - window creation functions .newwin(3X) 

suffix - file-name suffix conventions.suffix(5) 

sum - print checksum and block count of a file.sum(l) 

summarizeand print an SCCS file.prs(l) 

summarize disk usage.du(l) 

summarize filesystem ownership .quot(lM) 

summarize filesystem ownership.quot_vxfs(lM) 

summarize file system quotas.repquota(lM) 

summarize, add, modify, delete, or copy file access control lists (ACLs) .chacl(l) 

summary files, accounting, create periodic.acctsh(lM) 

summary log of uucp and uux transactions, access .uucp(l) 

super-block, update.sync(2) 

superblock .glossary(9) 

superior directory.glossary(9) 

superuser .glossary(9) 

superuser.passwd(l) 

superuser, change login name to.su(l) 

supplementary group ID .glossary(9) 

support for local network packet routing, system.routi ng(7) 

supported terminal video attributes, get .termattrs(3X) 

suppress echo while reading password from terminal .getpass(3C) 

surface device access module, SCSI .autochanger(7) 

suspend Curses session.endwin(3X) 

suspend execution for a time interval .sleep(l) 

suspend execution for an interval .usleep(2) 

suspend execution for interval .sleep(3C) 

suspend execution of a thread .pthread_resume_np(3T) 

suspend for asynchronous I/O completion .aio_suspend(2) 

suspend foreground until background processes are finished .wait(l) 

suspend or resume auditing on current process.audswitch(2) 

suspend process until signal.pause(2) 

suspend the cal ling process .napms(3X) 

svcerr_auth () - library routines for server side remote procedure call errors.rpc_svc_err(3N) 

svcerr decode () -1 ibrary routi nes for server side remote procedure call errors.rpc_svc_err(3N) 

svcerr noproc () -1 ibrary routi nes for server side remote procedure call errors.rpc_svc_err(3N) 

svcerr_noprog () -1 ibrary routi nes for server side remote procedure call errors.rpc_svc_err(3N) 

svcerr_progvers () -1 ibrary routi nes for server side remote procedure call errors.rpc_svc_err(3N) 

svcerr_systemerr () -1 ibrary routi nes for server side remote procedure call errors.rpc_svc_err(3N) 

svcerr weakauth () -1 ibrary routi nes for server side remote procedure call errors.rpc_svc_err(3N) 

svcfd create () - obsolete I ibrary routi nes for RPC .rpc_soc(3N) 

svcraw create () - obsolete I ibrary routi nes for RPC .rpc_soc(3N) 

svctcp create () - obsolete I ibrary routi nes for RPC .rpc_soc(3N) 

svcudp_buf create () - obsolete I ibrary routi nes for RPC .rpc_soc(3N) 

svcudp create () - obsolete I ibrary routi nes for RPC .rpc_soc(3N) 

svc_auth_reg () -1 ibrary routi nes for registeri ng servers .rpc_svc_reg(3N) 

svc_controi () - library routi nes for thecreation of server handles.rpc_svc_create(3N) 

svc_create () - library routi nes for thecreation of server handles.rpc_svc_create(3N) 

svc_destroy () -1 ibrary routi nes for the creation of server handles.rpc_svc_create(3N) 

svc_dg create () - library routines for thecreation of server handles.rpc_svc_create(3N) 
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svc dg enabiecache () - library routines for RPC servers.rpc_svc_calls(3N) 

svc_done() -1ibrary routines for RPC servers.rpc_svc_calls(3N) 

svc_exit () - library routi nes for RPC servers.rpc_svc_calls(3N) 

svc_fds() - obsolete library routines for RPC .rpc_soc(3N) 

svc fdset () - library routi nes for RPC servers.rpc_svc_calls(3N) 

svc_fd_ create () - library routines for the creation of server handles .rpc_svc_create(3N) 

svc_freeargs () - library routines for RPC servers.rpc_svc_calls(3N) 

svc_getargs () -1 i brary routi nes for RPC servers.rpc_svc_calls(3N) 

svc_getcaiier () - obsolete library routines for RPC .rpc_soc(3N) 

svc_getreq() - obsolete library routines for RPC .rpc_soc(3N) 

svc_getreqset () -1 i brary routi nes for RPC servers.rpc_svc_calls(3N) 

svc_getreq_common () -1 i brary routi nes for RPC servers.rpc_svc_calls(3N) 

svc getreg poll o - library routines for RPC servers.rpc_svc_calls(3N) 

svc_getrpcaiier () - library routines for RPC servers.rpc_svc_calls(3N) 

svc_poiiset () - library routi nes for RPC servers.rpc_svc_calls(3N) 

svc_raw_create () - library routines for the creation of server handles .rpc_svc_create(3N) 

svc reg () -1 ibrary routi nes for registeri ng servers .rpc_svc_reg(3N) 

svc_register () - obsolete I ibrary routi nes for RPC .rpc_soc(3N) 

svc_run() -1 ibrary routi nes for RPC servers.rpc_svc_calls(3N) 

svc sendrepiy () -1 ibrary routi nes for RPC servers.rpc_svc_calls(3N) 

svc_tii_create () - library routi nes for thecreation of server handles.rpc_svc_create(3N) 

svc_tp_create () - library routi nes for thecreation of server handles.rpc_svc_create(3N) 

svc_unreg() -1 ibrary routi nes for registeri ng servers .rpc_svc_reg(3N) 

svc_unregister () - obsolete I ibrary routi nes for RPC .rpc_soc(3N) 

svc_vc_create () - library routi nes for thecreation of server handles.rpc_svc_create(3N) 

swab() - swap bytes .swab(3C) 

swaci - view or modify Access Control Lists.swacl(lM) 

swagent - perform software management tasks as the agent of an SD command .swagentd(lM) 

swagentd - serve local or remote software management tasks .swagentd(lM) 

swap bytes.swab(3C) 

swap device for interleaved paging and swapping, add a.swapon (2) 

swap space information, system.swapinfo(lM) 

swap the left-to-right text character sequence in each line of a file.rev(l) 

swap up to eight characters (to first tab in line) to end of line.newform(l) 

swap volume, prepareLVM logical volume to be .Ivlnboot(lM) 

swap volume, remove LVM logical volumelink.Ivrmboot(lM) 

swapcontext () - manipulate user contexts.makecontext(2) 

swapinfo - system paging space information .swapinfo(lM) 

swapon - enabledevice or filesystem for paging .swapon(lM) 

swapon() - add swap device for interleaved paging and swapping .swapon (2) 

swapping, add swap device for interleaved.swapon(2) 

swapping, enabledevice or filesystem.swapon(lM) 

swapping, filesystem.swapon(2) 

swask - ask for user response for SD-UX .swask(lM) 

swconfig - configure, unconfigure, reconfigure installed software.swconfig(lM) 

swcopy - copy software products for subsequent installation or distribution .swinstall(lM) 

swgettoois - utility for retrieving theSD product from new SD media .swgettools(lM) 

swinstaii - install and configure software products.swinstall(lM) 

switch between screens .set_term(3X) 

switch - define switch statement .csh(l) 

switch to a new group.newgrp(l) 

switched virtual circuit, clear X.25 .clrsvc(lM) 

swjob - displayjob information and remove jobs.swjob(lM) 

swiist - display information about software products .swlist(lM) 

swmodify - modify software products in a target root or depot .swmodify(l) 

swpackage - package software products into a target depot or tape.swpackage(lM) 

swpackage - product specification file (PSF) format.swpackage(4) 

swreg - register or unregister depots and roots.swreg(lM) 

swremove - unconfigure and remove software products .swremove(lM) 

swverify - verify software products .swverify(lM) 

symbol and linenumber information, stripfrom an object file .strip(l) 
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symbol tablefor object codefile, print.nm(l) 

symbol table structure format .nlist(4) 

symbol table, regenerate archive.ranlib(l) 

symbol, get information for a global kernel symbol .getksym(2) 

symbol, look up in shared library .shl_load(3X) 

symbolic (soft) file link .symlink(4) 

symbolic constants, standard structures and.unistd(5) 

symbol i c I i n k . gl ossary(9) 

symbolic link to a file, make a .symlink(2) 

symbolic link, get status.Istat(2) 

symbolic link, read valueof.readlink(2) 

symbolic links between files or directories, create.In(l) 

symbolic translation file for localedef scripts.charmap(4) 

symbolically link NIS+objects.nisln(l) 

symiink - symbolic file li nk .symlink(4) 

symiink () - make symbolic link to a file.symlink(2) 

sync - flush unwritten system buffers to disk .sync(lM) 

sync the nis+password table with the nis+trusted table .ttsyncd(lM) 

sync() - update super-block.sync(2) 

syncer - periodically sync for filesystem integrity .syncer(lM) 

synchronisea window with its parents or children.syncok(3X) 

synchronize a file's in-core state with its state on disk.fsync(2) 

synchronize a mapped file.msync(2) 

synchronize asynchronous I/O .aio_fsync(2) 

synchronize stale logical volume mirrors in LVM volume groups .vgsync(lM) 

synchronizestalemirrors in LVM logical volumes .Ivsync(lM) 

synchronize the system clock, correct the time to .adjtime(2) 

synchronize transport library for transport endpoint (X/OPEN TLI-XTI) .t_sync(3) 

synchronous I/O multiplexing .select(2) 

syncok() - synchronise a wi ndow with its parents or children .syncok(3X) 

syntax, a shell (command interpreter) with C-like.csh(l) 

syntax, gated configuration file .gated.conf(4) 

sysconf () - get configurablesystem variables.sysconf(2) 

sysdef - display system definition .sysdef(lM) 

sysfs () - get file system type info.sysfs(2) 

sysiog () - write message onto system log file.syslog(3C) 

sysiogd - log system messages.syslogd(lM) 

system accounting, shell procedures for .acctsh(lM) 

system activity daily report package.sal(lM) 

system activity reporter .sar(lM) 

system administration manager.sam(lM) 

system administrator .passwd(l) 

system alias database.elm(l) 

system alias text file.elm(l) 

system alias: install new elm aliases.newalias(l) 

system aliases, elm, verify and display.elmalias(l) 

system asynchronous I/O .glossary(9) 

system buffers, flush unwritten buffers to disk.sync(lM) 

system buffers, periodically flush unwritten buffers to disk .syncer(lM) 

system call .glossary(9) 

system call or event audit status, change or display.audevent(lM) 

system call, data returned by stat/fstat/istat .stat(5) 

system calls and events currently being audited, get .getevent(2) 

system calls and events to be audited.setevent(2) 

system calls, BSD-4.2-compatiblekiii (), sigvec(), and signaio .bsdproc(3C) 

system calls, BSD-4.2-compatiblekiii (), sigvec(), and signaio .killpg(2) 

system calls, introduction.intro(2) 

system calls, STREAMS.stream(2) 

system clock dateand time, get.gettimeofday(2) 

system clock, correct theti me to synchronize the .adjtime(2) 

system clock, display current dateand time or set to new value.date(l) 
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system configuration file, change.ch_rc(lM) 

system configuration/DHCP support script.autoparms(lM) 

system console.glossary(9) 

system console interface special file .console(7) 

system data types, primitive.types(5) 

system database of automatically pushed STREAMS modules, manage.autopush(lM) 

system default database entry, manipulate.getprdfent(3) 

system default database file, trusted system.default(4) 

system definition, display.sysdef(lM) 

system diagnostic messages, collect to form error log .dmesg(lM) 

system error messages.perror(3C) 

system file, create a kernel .create_sysfile(lM) 

system.glossary (9) 

system information, display .uname(l) 

system information, get.uname(2) 

system loader, initial .isl(lM) 

system log, control .syslog(3C) 

system log, make entries in.logger(l) 

system login data, display .logins(lM) 

system maintenance commands and application programs, introduction.intro(lM) 

system messages, log .syslogd(lM) 

system name, display/set.uname(l) 

system name, get/set.uname(2) 

system nice value.renice(l) 

system of process's expected paging behavior, advise.madvise(2) 

system over LAN, log in on another.vt(l) 

system paging space information .swapinfo(lM) 

system parameter, query, set, or reset system parameter .kmtune(lM) 

system physical environment daemon .envd(lM) 

system process .glossary(9) 

system resource consumption limit, get or set .getrlimit(2) 

system scheduling priority .renice(l) 

system shells, overview of various.sh(l) 

system shutdown, turn accounting off for .acctsh(lM) 

system startup and shutdown, timed.power_onoff(lM) 

system startup, start accounting process at .acctsh(lM) 

system status server .rwhod(lM) 

system support for local network packet routing.routing(7) 

system to UNIX system command execution, UNIX .uux(l) 

system to UNIX system file copy, publicUNIX .uuto(l) 

system uptime, show .uptime(l) 

system users, list current .who(l) 

system variables, get configurable.sysconf(2) 

system() - issuea shell command .system(3S) 

system, auditing.see audit 

system, boot .reboot(2) 

system, call another (UNIX); terminal emulator .cu(l) 

system, display and update information about top processes on.top(l) 

system, display information .uname(l) 

system, get information.uname(2) 

system, list users currently on the.users(l) 

system, log in to.login(l) 

system, scan for disk arrays.arrayscan(lM) 

system, scan the I/O .ioscan(lM) 

system, send LP request to remote.rlp(lM) 

system, set node name.uname(l) 

system, set node name.uname(2) 

system, set or display name of current host .hostname(l) 

system, trusted system device assignment database file.devassign(4) 

system-calls error indicator.errno(2) 

system-wide clock, get current valueof.getclock(3C) 
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system-wide dock, setvalueof.setclock(3C) 

system-widesendmail aliases, print .praliases(l) 

system: configure and buildan HP-UX system .config(lM) 

system: configure crash dumps.crashconf(lM) 

system: configure system crash dumps.crashconf(2) 

systems with label checking, copy file.volcopy(lM) 

systems with label checking, copy file.volcopy_hfs(lM) 

systems, uucp, list names of known .uucp(l) 

sys erriist () - system error messages.perror(3C) 

sys nerr () - system error messages.perror(3C) 

table/etc/mnttab, establish mount.setmnt(lM) 

tablefunctions, NIS+.nis_tables(3N) 

table preprocessor for nroff.tbl(l) 

table, eliminateduplicateentries in a .lsearch(3C) 

table, linear search for entry; optional update if missing.lsearch(3C) 

table, mounted filesystem.mnttab(4) 

table, symbol, for object codefile, print.nm(l) 

table, time zone adjustment, for date and ctime .tztab(4) 

table, translate host-to-name-server file format.hosts_to_named(lM) 

tables manually, manipulate routing.route(lM) 

tables, binary search routine for sorted.bsearch(3C) 

tables, generate iconv translation .genxlt(l) 

tables, hash search, manage.hsearch(3C) 

tables, populateNIS+tablesin a NIS+domain .nispopulate(lM) 

tabs - set tabs on a terminal .tabs(l) 

tabs, convert to spaces and vice versa.expand(l) 

tacct (total accounting) file, print any.acctsh(lM) 

taddr2uaddr () - generic transport name-to-address translation .netdir(3N) 

tags file, create a.ctags(l) 

tail - get lines from last part of a file .tail(l) 

tailsthemail log.mtail(lM) 

talk - talk to another user .talk(l) 

talk to another user .talk(l) 

talk to the keyserv process.keyenvoy(lM) 

taikd - remote user communication server.talkd(lM) 

tan () - tangent function .tan(3M) 

tand() - tangent function (degrees) .tand(3M) 

tandf () - tangent function (float, degrees) .tand(3M) 

tanf() - tangent function (float) .tan(3M) 

tangent function (degrees) .tand(3M) 

tangent function .tan(3M) 

tangent function, inverse hyperbolic.atanh(3M) 

tangent functions, hyperbolic.tanh(3M) 

tanh (), tanhf () - hyperbolic tangent functions.tanh(3M) 

tanhf (), tanh () - hyperbolic tangent functions.tanh(3M) 

tape archive format, tar .tar(4) 

Tape Cartridge I/O Utility, CS/80.tcio(l) 

tape cartridge, partition DDS .mediainit(l) 

tape device access drivers, cartridge.ct(7) 

tape dump and restore protocol module, remote magnetic.rmt(lM) 

tape file archiver.tar(l) 

tape files: convert, reblock, translate, and copy .dd(l) 

tape I/O, faster .ftio(l) 

tape, package software products into.swpackage(lM) 

tape, SCSI sequential access device driver .scsi_tape(7) 

tapel, magnetic tape i nterface for stape, tape2 and .mt(7) 

tape2, magnetic tape interface for stape,tapel, and .mt(7) 

tar tape archive format .tar(4) 

tar - tape file archiver .tar(l) 

target depot, package software products into.swpackage(lM) 

target process, force to run serially with other processes .serialize(l) 


ndex-150 Hewlett-Packard Company 


HP-UX Release 11.0: October 1997 
































































Index 
All Volumes 

Description Entry Name(Section) 

target root, modify software products in depot or.swmodify(lM) 

tbi - table preprocessor for nroff.tbl(l) 

tbl, nroff/troff, and neqn constructs, remove .deroff(l) 

tcdrain (): tty linecontrol function .tccontrol(3C) 

tcflow(): tty linecontrol function .tccontrol(3C) 

tcflush (): tty linecontrol function .tccontrol(3C) 

tcgetattr () - get tty device operating parameters .tcattribute(3C) 

tcgetpgrp (): get foreground process group ID .tcgetpgrp(3C) 

tcgetsid() - get terminal session ID.tcgetsid(3C) 

tcio - Command Set 80CartridgeTape Utility.tcio(l) 

TCP connection, identify user.idlookup(l) 

tcp -1 nternet Transmission Control Protocol .TCP(7P) 

TCP/IP I DENT protocol server .identd(lM) 

tcsendbreak (): tty linecontrol function .tccontrol(3C) 

tcsetattr () - set tty device operating parameters.tcattribute(3C) 

tcsetpgrp () - set foreground process group ID .tcsetpgrp(3C) 

t delete () - delete a node from a binary search tree.tsearch(3C) 

tee - pipe fitting.tee(l) 

teiidir () - get current location of named directory stream.directory(3C) 

teim - STREAMS Telnet (pseudo-terminal) driver.tels(7) 

Telnet drivers, STREAMS .tels(7) 

Telnet port identification feature, dedicated ports file used by DDFA software and.dp(4) 

TELNET protocol server .telnetd(lM) 

TELNET protocol, user interface to the.telnet(l) 

telnet - user interfaceto theTELNET protocol .telnet(l) 

telnetd - TELNET protocol server .telnetd(lM) 

teis - STREAMS Telnet (pseudo-terminal) driver.tels(7) 

temperature environment, handleover-.envd(lM) 

tempnam() - create a name for a temporary file.tmpnam(3S) 

temporary (unique) file name, make a.mktemp(3C) 

temporary file, create a name for .tmpnam(3S) 

temporary file, create a .tmpfile(3S) 

temporary file, make a name for a .mktemp(l) 

term - format of compiled terminfo file.term(4) 

term - terminal capabilities.term_c(4) 

term.h - terminal capabilities.term_c(4) 

termattrs () - get supported terminal video attributes.termattrs(3X) 

termcap database emulation .tgetent(3X) 

termcap description, convert into a terminfo description .captoinfo(lM) 

termcap () access routines, emulate/etc/.termcap(3X) 

terminal affiliation.glossary(9) 

terminal baud rate, get.baudrate(3X) 

terminal block mode interface.blmode(7) 

terminal block-mode library interface.blmode(3C) 

terminal capabilities.term_c(4) 

terminal capabilities, disableuseof.filter(3X) 

terminal capabilities, get from terminfo database.tput(l) 

terminal capability database.terminfo(4) 

terminal characteristics for cue, set .cuegetty(lM) 

terminal connection, set terminal type, modes, speed and linedisciplinefor 2-way line.uugetty(lM) 

terminal control database entry, manipulate.getprtcent(3) 

terminal control database.ttys(4) 

Terminal Controller Device File Access software, Data Communications and.ddfa(7) 

terminal device.glossary(9) 

terminal device, control (Bell Version 6 compatibility) .stty(2) 

terminal echo, enable/disable.echo(3X) 

terminal emulator, I BM 3179G/3192G, 3270, 3777 .sna(l) 

terminal emulator, keyboard mapping.itemap(lM) 

terminal emulator; call another (UNIX) system .cu(l) 

terminal .glossary(9) 

terminal I/O, block-mode library interface for.blmode(3C) 
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terminal insert and delay capability, query functions.has_ic(3X) 

terminal interface device file, process-controlling.tty(7) 

terminal interface, extended general .termiox(7) 

terminal interface, general .termio(7) 

terminal interface, Version 6/PWB-compatibile.sttyv6(7) 

terminal lineconnection, establish an out-bound .dial(3C) 

terminal linedisciplinemodule, STREAMS.Idterm(7) 

terminal mode, save/restore .resetty(3X) 

terminal name, get .termname(3X) 

terminal or pseudo-terminal, get name of user's.tty(l) 

terminal output control functions .clearok(3X) 

terminal refresh, immediate, enabl^disable .immedok(3X) 

terminal screen, clear.clear(l) 

terminal screen, number of columns.COLS(3X) 

terminal screen, number of lines.LINES(3X) 

terminal session ID, get.tcgetsid(3C) 

Terminal Session Manager state information, get .tsm.info(l) 

Terminal Session Manager .tsm(l) 

terminal session, record typescript of.script(l) 

terminal session, start.login(l) 

terminal settings and datacomm line speed used by getty .gettydefs(4) 

terminal type, modes, speed and linediscipline, set for 2-way line.uugetty(lM) 

terminal type, modes, speed, and linediscipline, set .getty (1M) 

terminal video attributes, get supported ones .termattrs(3X) 

terminal, convert underscores to underlining on.ul(l) 

terminal, deny or permit writefl) messages from other users to.mesg(l) 

terminal, find name of.ttyname(3C) 

terminal, generate file name of controlling.ctermid(3S) 

terminal, get a multi-byte character length limited stringfrom .getnstr(3X) 

terminal, get a multi-byte character string.getstr(3X) 

terminal, get a single-bytecharacter.getch(3X) 

terminal, get a wide character from .get_wch(3X) 

terminal, get an array of wide characters and function key codes.getn_wstr(3X) 

terminal, get name of user logged in on thisterminal.getlogin(3C) 

terminal, get name.termname(3X) 

terminal, get verbose description of.longname(3X) 

terminal, identify type.ttytype(l) 

terminal, information on current terminal .cur_term(3X) 

terminal, initializebased on terminal type .tset(l) 

terminal, lock against use by others.lock(l) 

terminal, output attributes.vidattr(3X) 

terminal, output commands to.putp(3X) 

terminal, output cursor movement commands to.mvcur(3X) 

terminal, pseudo-terminal driver.pty(7) 

terminal, read password from whilesuppressingecho.getpass(3C) 

terminal, remote, spawn getty to (call terminal).ct(l) 

terminal, set options for port.stty(l) 

terminal, set tabs on a .tabs(l) 

terminal-type data basefor each tty port .ttytype(4) 

terminal: spawn getty to (call) remote terminal .ct(l) 

terminals, CRT, peruse file on.more(l) 

terminals, HP 2640- and HP 2621-series, handlespecial functionsof.hp(l) 

terminals, VT320, VT100, Wyse60 .cue(l) 

terminals, VT320, VT100, Wyse60 .sam(lM) 

terminals, VT320, VT100, Wyse60 .swinstall(lM) 

terminals, VT320, VT100, Wyse60.swremove(lM) 

terminatea per-processtimer.rmtimer(3C) 

terminate a process.kill(l) 

terminateall active processes.killali(lM) 

terminateall system processing .shutdown(lM) 

terminate, causethecallingthread to terminate.pthread_exit(3T) 
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terminate, wait for background processes to.wait(l) 

terminate, wait for child process to .wait(2) 

terminated, determine how last I/O read .io_get_term_reason(3l) 

terminating PAM sessions.pam_open_session(3) 

termination character on special file, set up I/O read .io_eol_ctl(3l) 

termination of a specified thread, wait for .pthreadJoin(3T) 

termination, register a function to be called at program.atexit(2) 

terminfo data base compiler .tic(lM) 

terminfodata base, de-compile .untic(lM) 

terminfo database, interfaces .del_curterm(3X) 

terminfo database, retrieve capabilities from .tigetflag(3X) 

terminfo de-compiler .untic(lM) 

terminfo description, convert from a termcap description .captoinfo(lM) 

terminfo descriptions, compare or printout.infocmp(lM) 

terminfo - printer, terminal, and modem capability database.terminfo(4) 

termio - general terminal interface.termio(7) 

termiox - extended general terminal interface.termiox(7) 

termname () - get terminal name.termname(3X) 

terms, glossary of .glossary(9) 

temuattrs () - get supported terminal video attributes.termattrs(3X) 

test contents of memory area .memory(3C) 

test - evaluatecondition for trueor false.test(l) 

test - evaluateconditional expression.csh(l) 

test - evaluateconditional expression .ksh(l) 

test - evaluateconditional expression .sh-posix(l) 

test mass storage media or device for recording integrity and proper operation .mediainit(l) 

test packets, send .ping(lM) 

test, initialize, and manipulatesignal sets.sigsetops(3C) 

text allocation space of object files, print section sizes and.size(l) 

text editor, line-oriented .ex(l) 

text editor, screen-oriented.vi(l) 

text editor: line-oriented .ed(l) 

text editors.see editor 

text file for CRT or line-printer output, format.nroff(l) 

text fileformat specification .fspec(4) 

text file.glossary(9) 

text file, change or reformat a .newform(l) 

text formatter .fmt(l) 

text formatters.see adjust 

text pattern scanning and processing language.awk(l) 

text processors: remove preprocessor lines.unifdef(l) 

text processors: reverse the left-to-right text character sequence in each line of a file.rev(l) 

text string, read from message file.gettxt(3C) 

text, lock in memory.plock(2) 

text, mathematical, preprocess and format for nroff.neqn(l) 

tfind() - get data pointer for binary search tree .tsearch(3C) 

tftp - trivial file transfer program.tftp(l) 

tftpd- trivial file transfer protocol server.tftpd(lM) 

tgetent () - get compiled terminfo data base entry into buffer .termcap(3X) 

tgetent () - termcap database emulation .tgetent(3X) 

tgetf lag () - get availability of compiled boolean terminal capability.termcap(3X) 

tgetf lag () - termcap database emulation .tgetent(3X) 

tgetnum () - get numeric value of compiled terminal capability.termcap(3X) 

tgetnum () - termcap database emulation .tgetent(3X) 

tgetstr () - get string value of compiled terminal capability .termcap(3X) 

tgetstr () - termcap database emulation .tgetent(3X) 

tgoto () - get compiled terminal cursor addressing string.termcap(3X) 

tgoto () - termcap database emulation .tgetent(3X) 

thread attribute object, initializeor destroy.pthread_attr_init(3T) 

thread cancellation cleanup handler, register or remove .pthread_deanup_pop(3T) 

thread condition variableattributesobject, initializeor destroy .pthread_condattr_init(3T) 
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thread condition variable, initializeor destroy . 

thread condition variable, wait or timed wait . 

thread ID for thecallingthread, obtain. 

thread identifiers, compare. 

thread of execution, create. 

thread process-shared attribute, get or set. 

thread, call an initialization routine only once, threads. 

thread, cancel execution of. 

thread-safe, get, set, or end network host entry. 

thread-safe, get, set, or end protocol entry. 

thread-safe, get, set, or end service entry . 

thread-specific data associated with a key, get or set . 

thread-specific data key, create or destroy. 

threads waiting on a condition variable, unblock . 

threads, POSlX.lc introduction . 

three-byte integers and long integers, convert between . 

three-way differential file comparison . 

three-way file merge . 

tic - terminfodata base compiler . 

tigetflag () - retrieve capabilitiesfrom theterminfo database .... 

tigetnum() - retrieve capabilitiesfrom theterminfo database. 

tigetstr () - retrieve capabilitiesfrom theterminfo database. 

time, times - print summary of time used by processes . 

time, times - print summary of time used by processes . 

time a command; report process accounting data and system activity 

time and date conversion. 

time and date, convert to string. 

time and date, convert to string . 

timeand date, convert to wide-character string. 

timeand date, get more precisely (Version 7 compatibility only) . 

timeand date, set via NTP. 

time between reboots, evaluate. 

time del ay, execute commands after. 

time interval, suspend execution for a. 

time limit for I/O operations, set. 

time - measure ti me used to execute a command . 

time - print accumulated shell and children process times. 

time - print summary of time used by shell and children. 

time profile, execution . 

time to leave, notify you when it is . 

time used, report CPU . 

time zone adjustment tablefor date and ctime . 

time zone display. 

time () - get time. 

time, convert user format date and. 

time, display current or set to new value. 

time, get system clock . 

time, get . 

time, set . 

timed wait or wait on a thread condition variable. 

timed, automatic system power on, and power off . 

timed-job execution daemon . 

timeout limit for I/O operations, set. 

timeout () - control blocking on input . 

timer operations . 

timer, allocate a per-process. 

ti mer, free a per-process . 

timer, get value of a per-process. 

timer, relatively arm a per-process . 

timer, set or get value of process interval . 

timer, set the interval timer . 


Entry Name(Section) 

.pthread_cond_init(3T) 

.pthread_cond_wait(3T) 

.pthread_self(3T) 

.pthread_equa!(3T) 

.pthread_create(3T) 

pthread_condattr_getpshared(3T) 

.pthread_once(3T) 

.pthread_cancel(3T) 

.gethostent(3N) 

.getprotoent(3N) 

.getservent(3N) 

.pthread_getspecific(3T) 

.pthread_key_create(3T) 

.pthread_cond_signal(3T) 

.pthread(3T) 

.l3tol(3C) 

.diff3(l) 

.merge(l) 

.tic(lM) 

.tigetflag(3X) 

.tigetflag(3X) 

.tigetflag(3X) 

.ksh(l) 

.sh-posix(l) 

.timex(l) 

.strptime(3C) 

.ctime(3C) 

.strftime(3C) 

.wcsftime(3C) 

.ftime(2) 

.ntpdate(lM) 

.last(l) 

.at(l) 

.sleep(l) 

.io_timeout_ctl(3l) 

.time(l) 

.sh-bourne(l) 

. csh(l) 

.profil(2) 

.leave(l) 

.clock(3C) 

.tztab(4) 

.date(l) 

.time(2) 

.getdate(3C) 

.date(l) 

.gettimeofday(2) 

.time(2) 

.stime(2) 

.pthread_cond_wait(3T) 

.power_onoff(lM) 

.cron(lM) 

.io_timeout_ctl(3l) 

.notimeout(3X) 

.timers(2) 

.mktimer(3C) 

.rmtimer(3C) 

.gettimer(3C) 

.reltimer(3C) 

.getitimer(2) 

.ualarm(2) 
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timer create () - create timer.timers(2) 

timer deiete() -deletetimer.timers(2) 

timer getoverrun() - return timer expiration count.timers(2) 

timer gettime () - store timer expiration and reload value.timers(2) 

timer_settime () - set timer expiration .timers(2) 

times - print accumulated user and system process times.sh-bourne(l) 

times () - get process and child process times.times(2) 

times, fileaccessand modification, set or update.utime(2) 

times, get process and child process.times(2) 

times, set file access and modification times.utimes(2) 

timeshare scheduling policy.rtsched(2) 

timex - time a command; report process accounting data and system activity.timex(l) 

timezone () - difference between UCT and local timezone.ctime(3C) 

timod - STREAMS modulefor converting ioctl() calls intoTransport I nterface messages.timod(7) 

tirdwr - STREAMS modulefor reads and writes by Transport I nterface users .tirdwr(7) 

TLI function, accept a connect request issued by a transport user .t_accept(3) 

TLI function, acknowledge receipt of orderly release indication at transport endpoint.t_rcvrel(3) 

TLI function, allocatea library structure.t_alloc(3) 

TLI function, bind address to transport endpoint .t_bind(3) 

TLI function, close transport endpoint .t_close(3) 

TLI function, disabletransport endpoint .t_unbind(3) 

TLI function, error message function.t_error(3) 

TLI function, establish connection with another transport user.t_connect(3) 

TLI function, establish transport endpoint .t_open(3) 

TLI function, free library structure.t_free(3) 

TLI function, get current state.t_getstate(3) 

TLI function, get protocol-specific service information .t_getinfo(3) 

TLI function, initiateorderly release at transport endpoint .t_sndrel(3) 

TLI function, listen for connect request.t_listen(3) 

TLI function, look at current event on transport endpoint.t_look(3) 

TLI function, manage options for transport endpoint.t_optmgmt(3) 

TLI function, receive confirmation from connect request .t_rcvconnect(3) 

TLI function, receive data over connection .t_rcv(3) 

TLI function, receive data unit from remote transport provider user.t_rcvudata(3) 

TLI function, receive error information from unit data error indication .t_rcvuderr(3) 

TLI function, retrieve disconnect information .t_rcvdis(3) 

TLI function, send data or expedited data over a connection.t_snd(3) 

TLI function, send data unit to transport user .t_sndudata(3) 

TLI function, send user-initiated disconnect request.t_snddis(3) 

TLI function, synchronize transport library for transport endpoint .t_sync(3) 

tmpfile () - create a temporary file.tmpfile(3S) 

tmpf ile64 () - file system API to support large files .fgetpos64(2) 

tmpnam () - create a name for a temporary file.tmpnam(3S) 

toascii () - translatecharacters to 7-bit ASCII .conv(3C) 

toiower (), _toiower - translatecharacters to lower-case.conv(3C) 

too many arguments (error); construct argument list(s) and execute command .xargs(l) 

tool, EISA configuration .eisa config(lM) 

tools to process 16-bit characters.nl_tools_16(3X) 

top - display and update information about top processes on system .top(l) 

topological sort .tsort(l) 

total accounting (tacct) file, print any.acctsh(lM) 

total accounting files, merge or add .acctmerg(lM) 

total accounting records, convert per-session records to.acctcon(lM) 

touch - updateaccess, modification, and/or change times of a file.touch(l) 

touchline () - window refresh control functions.is_linetouched(3X) 

touchwin() - window refresh control function .touchwin(3X) 

toupper (), _toupper, - translatecharacters to upper-case.conv(3C) 

towlower () - translate wide characters to lowercase.wconv(3C) 

towupper() - translate wide characters to uppercase .wconv(3C) 

tparm () - retrieve capabilities from theterminfo database.tigetflag(3X) 

tput - query theterminfo database.tput(l) 
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tputs () - decode terminal string padding information .termcap(3X) 

tputs() - output commands to the terminal .putp(3X) 

tr - translate selected characters .tr(l) 

trace and log command, configure subsystem database.nettlconf(lM) 

trace messages to standard output, write STREAMS event trace messages .strace(lM) 

trace, multithreaded process .ttrace(2) 

trace, process.ptrace(2) 

tracing and logging binary files, format .netfmt(lM) 

tracing and logging configuration file, Network .nettlgen.conf(4) 

tracing, control network .nettl(lM) 

traffic statistics, print mail .mailstats(l) 

transactions, list spooled uucp transactions grouped by transaction .uuls(lM) 

transcription system .answer(l) 

transfer files between systems .ftp(l) 

transfer files using XMODEM-protocol .umodem(l) 

transfer NIS database from NIS server to local node.ypxfr(lM) 

transfer program, trivial file.tftp(l) 

transfer protocol server, file .ftpd(lM) 

transfer protocol server, trivial file.tftpd(lM) 

transfer speed, inform system of required minimum I/O .io_speed_ctl(3l) 

transfer uucp-system files in or out .uucico(lM) 

translate character code to another code set .iconv(l) 

translate character code to another code set .iconv(3C) 

translate characters to upper-case, lower-case, or 7-bit ASCII .conv(3C) 

translate host table to name server file format .hosts_to_named(lM) 

translate selected characters .tr(l) 

translate wide characters to uppercase or lowercase .wconv(3C) 

translate, convert, reblock and copy a (tape) file.dd(l) 

translation file for localedef scripts, symbolic.charmap(4) 

translation tables to a readable format, dump iconv.dmpxlt(l) 

translation tables, generate iconv.genxlt(l) 

translation, class-dependent data, of ELF files.elf_xlate(3E) 

translation, generic transport name-to-address .netdir(3N) 

transport endpoint, acknowledge receipt of release (X/OPEN TLI-XTI) .t_rcvrel(3) 

transport endpoint, disable(X/OPEN TLI-XTI) .t_unbind(3) 

transport endpoint, establish (X/OPEN TLI-XTI).t_open(3) 

transport endpoint, initiateorderly release (X/OPEN TLI-XTI) .t_sndrel(3) 

transport endpoint, manage options (X/OPEN TLI-XTI) .t_optmgmt(3) 

transport endpoint, synchronize transport library (X/OPEN TLI-XTI).t_sync(3) 

transport files, scheduleuucp .uusched(lM) 

transport function argument structures (X/OPEN TLI-XTI), allocate library structure.t_alloc(3) 

Transport Interface messages: STREAMS modulefor converting ioctl().timod(7) 

Transport Interface: STREAMS modulefor reads and writes .tirdwr(7) 

transport library, synchronize (X/OPEN TLI-XTI).t_sync(3) 

transport provider user (X/OPEN TLI-XTI) .t_rcvudata(3) 

transport user, accept connect request (X/OPEN TLI-XTI) .t_accept(3) 

transport user, establish connection (X/OPEN TLI-XTI) .t_connect(3) 

transport user, send data unit (X/OPEN TLI-XTI) .t_sndudata(3) 

trap enable bits: getting .fegettrapenable(3M) 

trap enable bits: setting.fesettrapenable(3M) 

trap - execute command upon receipt of signal.sh-bourne(l) 

trap - trap specified signal .ksh(l) 

trap - trap specified signal .sh-posix(l) 

traverse (walk) a file tree, executing a function .ftw(3C) 

traverse a binary search tree.tsearch(3C) 

tree, manage a binary search .tsearch(3C) 

tree, search directory tree for files .find(l) 

tree, walk a file, executing a function .ftw(3C) 

triangle, right, hypotenuse of a.hypot(3M) 

trigonometric arccosine functions (degrees).acosd(3M) 

trigonometric arccosine functions.acos(3M) 
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trigonometric arcsine functions (degrees) .asind(3M) 

trigonometric arcsine functions .asin(3M) 

trigonometric arctangent functions (degrees) .atand(3M) 

trigonometric arctangent functions.atan(3M) 

trigonometric arctangent-and-quadrant functions .atan2(3M) 

trigonometric arctangent-and-quadrant functions (degrees) .atan2d(3M) 

trigonometric cosine functions (degrees) .cosd(3M) 

trigonometric cosine functions.cos(3M) 

trigonometric sine functions (degrees) .sind(3M) 

trigonometric sine functions.sin(3M) 

trigonometric tangent functions (degrees).tand(3M) 

trigonometric tangent functions.tan(3M) 

trivial file transfer program .tftp(l) 

trivial filetransfer protocol server.tftpd(lM) 

troff/nroff files, check .checknr(l) 

troff/nroff, tbl, and neqn constructs, remove .deroff(l) 

true - do nothing and return zero exit status.true(l) 

true, wait until the requested status condition becomes .hpib_status_wait(3l) 

true/false evaluate condition for .test(l) 

trunc() - truncation function .trunc(3M) 

truncate an existing file to zero for rewriting .creat(2) 

truncate text from beginning of line to specified column.newform(l) 

truncate text line to specified maximum length .newform(l) 

truncate () - truncate a file to a specified length.truncate(2) 

truncate64 () - file system API to support large files.creat64(2) 

truncation function .trunc(3M) 

trusted system device assignment database file .devassign(4) 

trusted system password database, get entry from .getspent(3C) 

trusted system, check if converted .iscomsec(2) 

trusted system, system default database file.default(4) 

trusted system, system device assignment database file.devassign(4) 

tsearch () - build and access a binary search tree.tsearch(3C) 

tset - terminal-dependent initialization .tset(l) 

tsm, add or remove a printer for use with.tsm.lpadmin(lM) 

tsm - Terminal Session Manager .tsm(l) 

tsm. command - send commands to Terminal Session Manager .tsm.command(l) 

tsm. info - get Terminal Session Manager state information .tsm.info(l) 

tsm. lpadmin - add or remove a printer for use with tsm.tsm.lpadmin(lM) 

tsort - topological sort .tsort(l) 

ttrace request, wait for.ttrace_wait(2) 

ttrace () - tracing facility for multithreaded process .ttrace(2) 

ttrace_wait - wait for ttrace () request.ttrace_wait(2) 

ttsyncd - daemon to maintain the nis-Hpassword table in sync with the nis-t-trusted table.ttsyncd(lM) 

tty baud rate, set or get.cfspeed(3C) 

tty device operating parameters, get or set.tcattribute(3C) 

tty - get the name of the user's terminal or pseudo-terminal .tty(l) 

tty .glossary(9) 

tty linecontrol functions.tccontrol(3C) 

tty port, terminal-type data base for each .ttytype(4) 

tty - process-controlling terminal interface device file.tty(7) 

ttyname (), isatty () - find name of a terminal .ttyname(3C) 

ttys and users, indicate last logins of .last(l) 

ttys - terminal control database.ttys(4) 

ttysiot () - find theslot in theutmpO file of the current user .ttyslot(3C) 

ttytype - data base of terminal-type for each tty port .ttytype(4) 

ttytype - terminal identification program.ttytype(l) 

tun - IP network tunnel driver .tun(4) 

tunable parameter, defauit_disk„ir.mount(lM) 

tunable parameters, display system.sysdef(lM) 

tunefs - tune up an existing HFS file system .tunefs(lM) 

tuning, network . ndd(lM) 
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tunnel driver, IP network .tun(4) 

turnacct - turn process accounting on or off .acctsh(lM) 

twaik () - traversea binary search tree.tsearch(3C) 

two files, compare.cmp(l) 

two sorted files, reject/select lines common to.comm(l) 

type attribute, get or set.pthread_mutexattr_getpshared(3T) 

type control characters, howto .ascii (5) 

type - show interpretation of nameas if a command .sh-bourne(l) 

type, classify characters according to .ctype(3C) 

type, classify characters according to .wctype(3C) 

type, determine file .file(l) 

type, determine file system .fstyp(lM) 

typeahead() - control checking for typeahead .typeahead(3X) 

typeahead, control checking for .typeahead(3X) 

types - primitive system data types.types(5) 

types, system data primitives .types(5) 

typescript of terminal session, record.script(l) 

typeset - control leading blanks and parameter handling .ksh(l) 

typeset - control leading blanks and parameter handling .sh-posix(l) 

tz environment variable.date(l) 

tzname () - name of local timezone .ctime(3C) 

tzset () - initialize timezone (), daylight (), and tzname () using TZ variable.ctime(3C) 

tztab - time zone adjustment tablefor date and ctime .tztab(4) 

t_accept () - accept a connect request issued by a transport user (X/OPEN TLI -XTI).t_accept(3) 

t_aiioc () - allocate library structure for transport function argument structures (X/OPEN TLI -XTI) t_alloc(3) 

t bind () - bind address to transport endpoint (X/OPEN TLI -XTI) .t_bind(3) 

t_close () - close transport endpoint (X/OPEN TLI-XTI).t_close(3) 

t_connect () - establish connection with another transport user (X/OPEN TLI-XTI) .t_connect(3) 

t_error () - error message function (X/OPEN TLI-XTI).t_error(3) 

t_free() - free memory for I i brary structure (X/OPE N TLI -XTI) .t_free(3) 

t^getinfo () - get protocol-specific service information (X/OPEN TLI-XTI) .t_getinfo(3) 

t^getprotaddr () - get protocol address (X/OPEN XTI).t_getprotaddr(3) 

t_getstate() - get current state (X/OPEN TLI-XTI) .t_getstate(3) 

t_listen() - listen for connect request (X/OPEN TLI-XTI).t_listen(3) 

t_iook() - look at current event on transport endpoint (X/OPEN TLI-XTI) .t_look(3) 

t_open() - establish transport endpoint (X/OPEN TLI-XTI).t_open(3) 

t^optmgmt () - manage options for transport endpoint (X/OPEN TLI-XTI).t_optmgmt(3) 

t_rcv() - receive normal or expedited data sent over connection (X/OPEN TLI-XTI).t_rcv(3) 

t_rcvconnect () - receive confirmation from connect request (X/OPEN TLI-XTI).t_rcvconnect(3) 

t_rcvdis () - retrieve information from disconnect (X/OPEN TLI-XTI) .t_rcvdis(3) 

t_rcvrei () - acknowledge receipt of release indication at transport endpoint (X/OPEN TLI-XTI).... t_rcvrel(3) 

t_rcvudata() - receive data unitfrom remote transport provider user (X/OPEN TLI-XTI).t_rcvudata(3) 

t_rcvuderr () - receive error information from unit data error indication (X/OPEN TLI-XTI) t_rcvuderr(3) 

t_snd() - send data or expedited data over a connection (X/OPEN TLI-XTI).t_snd(3) 

t_snddis () - send user-initiated disconnect request (X/OPEN TLI-XTI) .t_sndis(3) 

t_sndrel () - initiateorderly release at transport endpoint (X/OPEN TLI-XTI) .t_sndrel(3) 

t__sndudata() - send data unit to transport user (X/OPEN TLI-XTI) .t_sndudata(3) 

t_strerror() - produce error message string (X/OPEN - XTI) .t_strerror(3) 

t_sync() - synchronize transport library for transport endpoint (X/OPEN TLI-XTI) .t_sync(3) 

t_unbind () - disable transport endpoi nt (X/OPE N TLI -XTI) .t_unbind(3) 

u370 - is processor an IBM 370?.machid(l) 

u3b - is processor a U3B?.machid(l) 

u3bl0 - is processor a U3B10? .machid(l) 

u3b2 - is processor a U3B2? .machid(l) 

u3b5 - is processor a U3B5? .machid(l) 

uaddr2taddr () - generic transport name-to-address translation .netdir(3N) 

uaiarm() - set the interval timer .ualarm(2) 

udp -1 nternet user datagram protocol .UDP(7P) 

udpubiickey - updates the pubiickey database file and NIS map .udpublickey(lM) 

UID, get name from (obsolete) .getpw(3C) 

ui - do underlining on terminal .ul(l) 
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uickpwdf () - control access to/etc7passwd file. 

ulimit - impose file size limit for child processes . 

ulimit - set size or ti me I i mits . 

ulimit - set size or ti me I i mits . 

ulimit () - get or set file size limits and break value. 

ultoa () - convert unsigned long integer to ASCII decimal . 

ultoa r () - convert unsigned long integer to ASCII decimal (MT-Safe). 

ultostr () - convert unsigned long integer to string. 

uitostr_r () - convert unsigned long integer to string (MT-Safe) . 

umask - set access permissions mode mask for file-creation . 

umask - set permissions mask for creating new files. 

umask - set permissions mask for creating new files . 

umask - set permissions mask for creating new files. 

umask - set permissions mask for creating new files. 

umaskf) - set and get filecreation (permissions) mask. 

umodem - XM ODE M-protocol file transfer program . 

umount - unmount a filesystem (generic). 

umount - unmount CDFS filesystems . 

umount - unmount HFS filesystems . 

umount - unmount NFS filesystems . 

umount - unmount VxFS filesystem. 

umount () - unmount a filesystem . 

umountaii - unmount multi pi efil e systems. 

unalias - discard specified alias. 

unalias - discard specified alias. 

unalias - discard specified alias. 

uname - display information about computer system; set node name (system name) 

uname () - get information about computer system . 

unbiased exponent function. 

unblock oneor all threads waiting on a conditional variable. 

uncompact previously compacted FI uffman coded files (see pack(l)). 

uncompact - uncompact FI uffman coded files (seepack(l) . 

uncompileterminfo data base. 

uncompress, compress, zcat - compress or expand data . 

uncompressdir, compressdir - compress or expand files in a directory . 

unconfigure, reconfigure, configure installed software . 

unctri () - generate printablerepresentation of a character . 

underflow mode: getting floating-point . 

underflow mode: setting floating-point. 

underlining on terminal, convert underscores to. 

underscores, convert to underlining on terminal. 

undial () - establish an out-bound terminal line connection . 

undo a previous get of an SCCS file . 

unexpand, expand - expand tabs to spaces, and vice versa. 

unexport and export directories to PFS clients. 

unexport directories to NFS clients. 

unget - undo a previous get of an SCCS file . 

ungetc () - push character back into input stream. 

ungetch () - push a character onto the i nput queue. 

ungetwc () - push wide character back i nto i nput stream . 

ungetwc unlocked () - unlocked version of ungetwcO. 

unget wch () - push a character onto the i nput queue. 

unhash - disable use of internal hash tables. 

unifdef - remove preprocessor lines. 

uninterpreted filecontents, retrieve for ELF files . 

Uninterruptible Power System (UPS), monitor daemon . 

Uninterruptible Power System monitor configuration file. 

uniq - report adjacent repeated lines in a file. 

unique(usually temporary) file name, make a. 

unistd.h - standard structures and symbolic constants. 

unit data error indication (X/OPEN TLI-XTI). 


Entry Name(Section) 

.lckpwdf(3C) 

.sh-bourne(l) 

.ksh(l) 

.sh-posix(l) 

.ulimit(2) 

.ltostr(3C) 

.ltostr(3C) 

.ltostr(3C) 

.ltostr(3C) 

.umask(l) 

. csh(l) 

.ksh(l) 

.sh-bourne(l) 

.sh-posix(l) 

.umask(2) 

.umodem(l) 

.mount(lM) 

.mountcdfs(lM) 

.mount_hfs(lM) 

.mount_nfs(lM) 

.mount_vxfs(lM) 

.umount(2) 

.mountall(lM) 

.csh(l) 

.ksh(l) 

.sh-posix(l) 

.uname(l) 

.uname(2) 

.ilogb(3M) 

pth r ead_con d_si gn a I (3T) 

.compact(l) 

.compact(l) 

.untic(lM) 

.compress(l) 

.compress(l) 

.swconfig(lM) 

.unctrl(3X) 

.fegetflushtozero(3M) 

.fesetflushtozero(3M) 

.ul(l) 

.Ul(l) 

.dial(3C) 

.unget(l) 

.expand(l) 

.pfs_exportfs(lM) 

.exportfs(lM) 

.unget(l) 

.ungetc(3S) 

.ungetch(3X) 

.ungetwc(3C) 

.ungetwc(3C) 

.ungetch(3X) 

. csh(l) 

.unifdef(l) 

.elf_rawfile(3E) 

.upsmond(lM) 

.ups_conf(4) 

.uniq(l) 

.mktemp(3C) 

.unistd(5) 

.t_rcvuderr(3) 
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Description 

units - convert units of measure. 

units of measure, convert. 

unix - local communication domain protocol . 

UNIX system to UNIX system command execution . 

UNIX system to UNIX system file copy, public . 

unlinka messagequeue . 

unlink a named semaphore. 

unlinka shared memory object. 

unlink - execute unlink () system call without error checks. 

unlink - remove directory entry; delete file. 

unlink () system call, execute without error checks. 

unload a kernel module on demand . 

unload shared library. 

unlock a mutex. 

unlock a POSIX semaphore. 

unlock a read-write lock . 

unlock a semaphore. 

unlock a STREAMS pty master/slave pair. 

unlock access to /etc/passwd file. 

unlock memory segment . 

unlock or lock an I/O interface . 

unlock process virtual address space . 

uniockpt () - unlock a STREAMS pty master and slave pair. 

unmap a mapped region . 

unmount a filesystem (generic). 

unmount a filesystem . 

unmount and mount CD-ROM filesystems. 

unmount CDFS filesystems . 

unmount HFS filesystems . 

unmount multiplefilesystems. 

unmount NFS filesystems . 

unmount VxFS filesystem. 

unpack - expand FI uffman coded files created by pack (see compact(l) 

unprintablecharacters in a file, make visibleor invisible. 

unregister or register depots and roots. 

unset - remove definition/setting of flags and arguments . 

unset - remove definition/setting of options and arguments. 

unset - remove definition/setting of options and arguments. 

unset - remove definition/setting of options and arguments. 

unsetenv - remove variablefrom environment . 

unsigned long integer to string, convert. 

untie - terminfo de-compiler . 

until - execute commands until expression is non-zero . 

until - execute commands until expression is nonzero . 

untouchwin() - window refresh control functions. 

unused DOS disk clusters, report number of . 

unwritten system buffers, flush to disk . 

unwritten system buffers, periodically flush to disk. 

updateaccess, modification, and/or change times of a file. 

updatean ELF descriptor. 

updatebackup LVM volume group configuration file. 

updatedefault kernel files or specified kernel modules. 

update execution time limit . 

updatefile access and modification times. 

update files on remote hosts . 

update secure password facility . 

updatestatus, line, functions. 

update super-block. 

updatetable if entry missing after search. 

updatethe public keys in a NIS+directory object . 

updateuser password in Network Information Service. 


Entry Name(Section) 

.units(l) 

.units(l) 

.UNIX(7P) 

.uux(l) 

.uuto(l) 

.mq_unlink(2) 

.semunlink(2) 

.shm_unlink(2) 

.link(lM) 

.unlink(2) 

.link(lM) 

.moduload(2) 

.shl_load(3X) 

. pthread_mutex_unlock(3T) 

.sem_post(2) 

pthread_rwlock_unlock(3T) 

.msem_unlock(2) 

.unlockpt(3C) 

.lckpwdf(3C) 

.munlock(2) 

.io_lock(3l) 

.munlockall(2) 

.uniockpt(3C) 

.munmap(2) 

.mount(lM) 

.umount(2) 

.pfs_mount(lM) 

.mountcdfs(lM) 

.mounthfs(lM) 

.mountall(lM) 

.mount_nfs(lM) 

.mount_vxfs(lM) 

.pack(l) 

. vis(l) 

.swreg(lM) 

. csh(l) 

.ksh(l) 

.sh-bourne(l) 

.sh-posix(l) 

. csh(l) 

.ltostr(3C) 

.untic(lM) 

.ksh(l) 

.sh-posix(l) 

.is_linetouched(3X) 

.dosdf(l) 

.sync(lM) 

.syncer(lM) 

.touch(l) 

.elf_update(3E) 

.vgcfgbackup(lM) 

.kmupdate(lM) 

.rtsched(2) 

.utime(2) 

.rdist(l) 

.pwconv(lM) 

.redrawwin(3X) 

.sync(2) 

.lsearch(3C) 

.nisupdkeys(lM) 

.yppasswd(3N) 
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update, add, delete a kernel module.kminstall(lM) 

update, install, or remove boot programs from a disk device.mkboot(lM) 

update, maintain, and regenerate groups of programs.make(l) 

updaters- configuration filefor NIS updating.updaters(lM) 

updates the pubiickey database file and NIS map .udpublickey(lM) 

updating, configuration filefor NIS .updaters(lM) 

upgrade disk layout of VxFS file system .vxupgradeflM) 

upper-case, translate characters to.conv(3C) 

uppercase, translate wide characters to.wconv(3C) 

UPS monitor configuration file .ups_conf(4) 

UPS, monitor daemon .ups mond(lM) 

upshifting.glossary(9) 

ups conf - HP PowerTrust UPS monitor configuration file.ups_conf(4) 

ups conf - Uninterruptible Power System (UPS) monitor configuration file.ups_conf(4) 

upsjnond - HP PowerTrust monitor daemon .ups mond(lM) 

ups mond - HP PowerTrust Uninterruptible Power System monitor daemon .upsmond(lM) 

upsjnond - Uninterruptible Power System monitor daemon .ups mond(lM) 

uptime - show how long system has been up.uptime(l) 

usage quotas, disk.quota(5) 

usage, summarize disk .du(l) 

use, disable, of certain terminal capabilities.filter(3X) 

user accounti ng file entry format for btmp (), utmp (), and wtmp () .utmp(4) 

user accounting information file.utmpx(4) 

user accounting, daily accounting shell procedure .runacct(lM) 

user alias database.elm(l) 

user alias text file.elm(l) 

user alias: install new elm aliases.newalias(l) 

user aliases, elm, verify and display.elmalias(l) 

user configuration files for pluggableauthentication modules .pam_user.conf(4) 

user context, get and set current .getcontext(2) 

user contexts, manipulate.makecontext(2) 

user credentials for an authentication service, modify and delete.pam_setcred(3) 

user crontab file operations .crontab(l) 

user datagram protocol, Internet .UDP(7P) 

user disk usage quotas.quota(5) 

User Environment (CUE), HP Character-Terminal .cue(l) 

user environment variables.environ(5) 

user format date and time, convert.getdate(3C) 

user group access and identification file, grp.h .group(4) 

user ID .glossary(9) 

user id, effective current, print or display.whoami(l) 

user ID, get real or effective .getuid(2) 

user ID, set .setuid(2) 

user IDs and names, print .id(l) 

user IDs, set real and effective user IDs .setreuid(2) 

user information in password file; used by finger, change.chfn(l) 

user information lookup program .finger(l) 

user information server, remote.fingerd(lM) 

user interface for gated.gdc(lM) 

user interface to theTELNET protocol .telnet(l) 

user login data, display .logins(lM) 

user login name, get character-string representation of .cuserid(3S) 

user login name, obtain .logname(3C) 

user login, display data .listusers(lM) 

user name directory service, Internet .whois(l) 

user name, PAM routine to retrieve.pam_get_user(3) 

user name: in elm aliases.newalias(l) 

user of a particular TCP connection, identify.idlookup(l) 

user or group IDs, set real, effective, and/or saved.setresuid(2) 

user password in Network Information Service, update.yppasswd(3N) 

user policy definition service module, PAM .pam_updbe(5) 
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user processes currently using a file or file structure.fuser(lM) 

user quotas, edit .edquota(lM) 

user shells, get legal.getusersheli(3C) 

user's effective access rights to a file, get a .getaccess(2) 

user's login environment, shell script to set up .profile(4) 

user's terminal or pseudo-terminal, get name of.tty(l) 

user, ask for user response for SD-UX .swask(lM) 

user, bill fee to, based on system usage.acctsh(lM) 

user, change login name to another .su(l) 

user, change user's secure RPC key .chkey(l) 

user, communicate interactively with another .write(l) 

user, current, find the slot in theutmpO fileofthe.ttyslot(3C) 

user, get name of user logged in on this terminal .getlogin(3C) 

user, show last login date for each .acctsh(lM) 

user2netname () - library routines for secure remote procedure calls.secure_rpc(3N) 

user: print list of current system users .who(l) 

useradd - add a user login on the system .useradd(lM) 

userdei - delete a user login from the system .userdel(lM) 

usermod - modify a user login on the system .usermod(lM) 

username server, network.rusersd(lM) 

users and processes, list current .whodo(lM) 

users and ttys, indicate last logins of .last(l) 

users - compact list of users currently on the system .users(l) 

users currently on the system, list.users(l) 

users on remote machines, return information about.rnusers(3N) 

users over a network, write to all .rwall(lM) 

users, notify of new mail in mailboxes.newmail(l) 

users, remote, authorizing access on local host.hosts.equiv(4) 

users, select for auditing .audusr(lM) 

users: list current users and what they are doing.whodo(lM) 

use env () - specify source of screen size information.use_env(3X) 

usieepo - suspend execution for an interval .usleep(2) 

ustat () - get mounted filesystem statistics .ustat(2) 

UTC (Coordinated Universal Time) .glossary(9) 

UTC, Coordinated Universal Time .date(l) 

utility for searching NIS+tables .nismatch(l) 

utility .glossary(9) 

utility options, parse .getopts(l) 

utility program for SCCS commands .sccs(l) 

utime () - set or update file access and modification times .utime(2) 

utimes() - set file access and modification times .utimes(2) 

utmp file.login(l) 

utmp record, write and include reason for writing .acct(lM) 

utmp (), wtmp (), btmp () - utmp, wtmp, btmp user accounting file entry format .utmp(4) 

utmp () file of the current user, find the slot in the.ttyslot(3C) 

utmp () or wtmp () file, access.getut(3C) 

utmpname () - change name of utmp () file being examined .getut(3C) 

utmpname r () - change name of utmp () file being examined .getut(3C) 

utmpx - user accounting information file.utmpx(4) 

utmpx () or wtmp () file, access.getutx(3C) 

uucheck - check theuucp directories and permissions file .uucheck(lM) 

uucico - transfer uucp-system files .uucico(lM) 

uuclean - uucp spool directory clean-up.uuclean(lM) 

uucleanup - uucp spool directory clean-up.uudeanup(lM) 

uucp, uulog, uuname - UNIX system to UNIX system copy.uucp(l) 

uucp-system files, transfer in or out .uucico(lM) 

uucp and uux transactions summary log, access .uucp(l) 

uucp or uux command requests from remote, execute on local system.uuxqt(lM) 

uucp spool directory clean-up .uuclean(lM) 

uucp spool directory clean-up.uudeanup(lM) 

uucp status inquiry and job control .uustat(l) 
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uucp subnetwork activity, monitor .uusub(lM) 

uucp systems, list names of known .uucp(l) 

uucp: check the uucp directories and permissions file.uucheck(lM) 

uucp: list spooled uucp transactions grouped by transaction.uuls(lM) 

uucp: scheduleuucp transport files.uusched(lM) 

uucp: set terminal type, modes, speed and line discipline for 2-way line.uugetty(lM) 

uucp: show snapshot of the UUCP system .uusnap(lM) 

uucp: uucleanup - uucp spool directory clean-up.uuclean(lM) 

uucpd() - server for supporting UUCP over TCP/I P networks.uucpd(lM) 

uudecode - decode a file encoded by uuencode .uuencode(l) 

uuencode - encodea binary filefor transmission by mailer.uuencode(l) 

uuencode - format of a uuencode(l)-encoded file.uuencode(4) 

uugetty - set terminal type, modes, speed and linedisciplinefor 2-way line.uugetty(lM) 

uuiog - access uucp and uux transactions summary log.uucp(l) 

uuis - list spooled uucp transactions grouped by transaction .uuls(lM) 

uuname - list names of known uucp systems.uucp(l) 

uupath, mkuupath - access and manage the pathaliasdatabase.uupath(l) 

uupick - accept or reject files sent by uuto .uuto(l) 

uusched - scheduleuucp transport files.uusched(lM) 

uusnap output, sort and embellish.uusnaps(lM) 

uusnap - show snapshot of the UUCP system.uusnap(lM) 

uusnaps - sort and embellish uusnap output .uusnaps(lM) 

uustat - uucp status inquiry and job control .uustat(l) 

uusub - monitor uucp subnetwork activity.uusub(lM) 

uuto - public U NIX system to U NIX system file copy .uuto(l) 

uux and uucp transactions summary log, access.uucp(l) 

uux or uucp command requests from remote, execute on local system.uuxqt(lM) 

uux -UNIX system to U NIX system command execution .uux(l) 

uuxqt - execute remote uucp or uux command requests on local system .uuxqt(lM) 

ux2dos, dos2ux - convert ASCII fileformat .dos2ux(l) 

vacation - return "I am not here" indication .vacation(l) 

vai - validatean SCCS file.val(l) 

validatean SCCS file.val(l) 

validate whether physical page number was dumped .cr_isaddr(3) 

validation procedures, perform PAM account .pam_acct_mgmt(3) 

vaiioc () - allocate space on boundary aligned to sysconf value.malloc(3C) 

valueoccurs, wait until a particular parallel poll .hpib_wait_on_ppoll(3l) 

valueof a per-process timer, get.gettimer(3C) 

valueof a symbolic link, read .readlink(2) 

valueof process interval timer, set or get .getitimer(2) 

valueof system-wide clock, get current.getclock(3C) 

valueof system-wide clock, set.setclock(3C) 

value, change or add to environment.putenv(3C) 

value, get or setfilesizelimitsand break.ulimit(2) 

value, return integer absolute.abs(3C) 

values and constantsfor programming, machine-dependent .values(5) 

values in a Network I nformation Service map, print all .ypcat(l) 

values - machine-dependent values.vaiues(5) 

values of selected keys in Network I nformation Service map, print the .ypmatch(l) 

values, convert between host and network byte order .byteorder(3N) 

values, get POSIX configuration.getconf(l) 

values, get string-valued configuration.confstr(3C) 

varargs argument list, print formatted output of a .vprintf(3S) 

varargs argument, formatted input conversion to a .vscanf(3S) 

varargs .h - macros for handling variableargument list .varargs(5) 

variableargument list macros.stdarg(5) 

variableargument list macros .varargs(5) 

variable, environment, search environment list for valueof.getenv(3C) 

variablesin the stable storage, display and modify.setboot(lM) 

variables, configurable path name, get.pathconf(2) 

variables, environment, print valueof .printenv(l) 
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variables, system, get configurable.sysconf(2) 

variables, user environment .environ(5) 

vax - is processor a VAX? .machid(l) 

vc - version control .vc(l) 

vector, get option letter from argument.getopt(3C) 

vedit - beginner's screen-oriented text editor .vi(l) 

verbose description of current terminal, get.longname(3X) 

verification tool, STREAMS .strvf(lM) 

verifier, generic filesystem quota consistency.quotacheck(lM) 

verifier, hfs file system quota consistency .quotachecknfs(lM) 

verifier, VxFS filesystem quota consistency .quotacheck vxfs(lM) 

verify a remote user as a local user .rcmd(3N) 

verify elm user and system aliases.elmalias(l) 

verify integrity of crash dump .cr_verify(3) 

verify integrity of mass storage media.mediainit(l) 

verify internal revision numbers of HP-UX files.revck(lM) 

verify LAN connectivity with link-level loopback.linkloop(lM) 

verify Network License Servers are working.i4tv(lM) 

verify program assertion .assert(3X) 

Version 6/PWB-compatibileterminal interface.sttyv6(7) 

version control .vc(l) 

version level of operating system, display.uname(l) 

version level of operati ng system, get.uname(2) 

version of an SCCS file, get a.get(l) 

versions of an SCCS file, compare two .sccsdiff(l) 

versions, coordinate ELF library and application.elf_version(3E) 

vfork () - spawn new process (use fork () instead).vfork(2) 

vfprintf () - print formatted output of a varargs argument list .vprintf(3S) 

vfscanf () - formatted input conversion to a varargs argument .vscanf(3S) 

vfsmount () - mount a file system .vfsmount(2) 

vgcfgbackup - create LVM volume group configuration backup file.vgcfgbackup(lM) 

vgcfgrestore - restore vol ume group configuration.vgcfgrestore(lM) 

vgchange - set LVM volume group availability.vgchange(lM) 

vgcreate - create LVM volume group.vgcreate(lM) 

vgdisplay - display information about LVM volume groups .vgdisplay(lM) 

vgexport - export an LVM volume group and its associated logical volumes .vgexport(lM) 

vgextend - extend an LVM volume group by adding physical volumes.vgextend(lM) 

vgimport - import an LVM volume group onto the system .vgimport(lM) 

vgreduce - remove physical volumes from an LVM volume group .vgreduce(lM) 

vgremove - remove LVM volume group definition from thesystem.vgremove(lM) 

vgscan - scan physical volumes for LVM volume groups .vgscan(lM) 

vgsync - synchronize stale logical volume mirrors in LVM volume groups .vgsync(lM) 

VHE home machineis not available, login when .vhe altlog(lM) 

vhe altiog: login when VHE home machineis not available.vhealtlog(lM) 

vhe iist - Virtual Home Environment information file.vhe_list(4) 

vhe mount e r: start the Virtual Home Environment (VHE) .vhe_mounter(lM) 

vhe u mnt: perform NFS mount to remote filesystem.vhe_u_mnt(lM) 

vi edit on the password file.vipw(lM) 

vi - extended screen-oriented text editor.vi(l) 

vidattr() - output attributes to terminal .vidattr(3X) 

video attributes, terminal, get supported .termattrs(3X) 

vidputs() - output attributes to terminal .vidattr(3X) 

vid attr () - output attributes to terminal .vidattr(3X) 

vid_puts() - output attributes to terminal .vidat±r(3X) 

view or modify Access Control Lists.swacl(lM) 

view - read-only screen-oriented text editor .vi(l) 

viewing, saving SAM Iogfile tool .samlog viewer 

vipw - edit the password file.vipw(lM) 

virtual circuit, X.25 switched, clear .clrsvc(lM) 

Virtual Home Environment (VHE), start the.vhe_mounter(lM) 

Virtual Home Environment information file.vhe_list(4) 


ndex-164 Hewlett-Packard Company 


HP-UX Release 11.0: October 1997 
































































Index 
All Volumes 

Description Entry Name(Section) 

virtual memory statistics, report .vmstat(l) 

virtual memory, map object into.mmap(2) 

virtual terminal requests from other systems, respond to.vtdaemon(lM) 

vis - make unprintableand non-ASCI I characters in a file visible.vis(l) 

viine () - draw lines from single-byte characters and renditions .hline(3X) 

viine set () - draw lines from complex characters and renditions.hline_set(3X) 

vmstat - report virtual memory statistics.vmstat(l) 

voicopy - copy file systems with label checking.volcopy(lM) 

volcopy - copy file systems with label checking.volcopy_hfs(lM) 

voicopy - copy VxFS filesystem with label checking .volcopy_vxfs(lM) 

volcopy vxfs - copy VxFS filesystem with label checking .volcopy_vxfs(lM) 

volume format, filesystem.fs(4) 

volume group (LVM) configuration backup file, create or update.vgcfgbackup(lM) 

volume group (LVM), change characteristics and access path of physical volume in .pvchange(lM) 

volume group (LVM), check or repair a physical volume in.pvck(lM) 

volume group (LVM), create logical volume in .Ivcreate(lM) 

volume group (LVM), create physical volume for usein .pvcreate(lM) 

volume group (LVM), create.vgcreate(lM) 

volume group (LVM), display information about physical volumes in .pvdisplay(lM) 

volume group (LVM), extend by adding physical volumes.vgextend(lM) 

volume group (LVM), import onto the system .vgimport(lM) 

volume group (LVM), reduce by removing physical volumes .vgreduce(lM) 

volume group (LVM), remove logical volumes from.Ivremove(lM) 

volume group and its associated logical volumes (LVM), export .vgexport(lM) 

volume group availability (LVM), set .vgchange(lM) 

volume group configuration, restore.vgcfgrestore(lM) 

volume group definition (LVM), remove from the system.vgremove(lM) 

volume group information file, LVM physical .Ivmpvg(4) 

volume group .Ivm(7) 

volume groups (LVM), display information about .vgdisplay(lM) 

volume groups (LVM), scan physical volumes for .vgscan(lM) 

volume groups (LVM), synchronize stale logical volume mirrors .vgsync(lM) 

volume header on LIF file, write.lifinit(l) 

volumein LVM volume group, create logical.Ivcreate(lM) 

volume mirrors in LVM volume groups, synchronizestalelogical .vgsync(lM) 

volume number .glossary(9) 

volumes from LVM volume group, remove logical .Ivremove(lM) 

vpfmt () - display message in standard format .pfmt(3C) 

vprintf () - print formatted output of a varargs argument list.vprintf(3S) 

vscanf () - formatted input conversion to a varargs argument .vscanf(3S) 

vsnprintf () - print formatted output of a varargs argument list.vprintf(3S) 

vsprintf () - print formatted output of a varargs argument list.vprintf(3S) 

vsscanf () - formatted input conversion to a varargs argument .vscanf(3S) 

vt - log in on another system over LAN .vt(l) 

vt requests from other systems, respond to.vtdaemon(lM) 

VTlOOterminal.cue(l) 

VTlOOterminal .sam(lM) 

VTlOOterminal.swinstall(lM) 

VTlOOterminal .swremove(lM) 

VT320 terminal.cue(l) 

VT320terminal .sam(lM) 

VT320terminal .swinstall(lM) 

VT320terminal .swremove(lM) 

vt daemon - respond to vt requests .vtdaemon(lM) 

vwprintw() - print formatted output in a window.vwprintw(3X) 

vwscanw () - convert formatted input from a window.vwprintw(3X) 

vw_printw() - print formatted output in a window.vw_printw(3X) 

vw scanw () - convert formatted input from a window.vwprintw(3X) 

vxdiskusg - generate disk accounting data of VxFS filesystem by user ID .vxdiskusg(lM) 

vxdump - local incremental filesystem dump.vxdump(lM) 

VxFS Advanced, get extent attributes.getext(lM) 
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VxFS Advanced, set extent attributes.setext(lM) 

VxFS filesystem control functions .vxfsio(7) 

VxFS filesystem debugger.fsdb_vxfs(lM) 

VxFS file system quota consistency checker .quotacheck vxfs(lM) 

VxFS file system volume, format .fs_vxfs(4) 

VxFS filesystem with label checking .volcopy_vxfs(lM) 

VxFS filesystem, cat .fscat_vxfs(lM) 

VxFS filesystem, check and repair .fsck_vxfs(lM) 

VxFS filesystem, construct.mkfs_vxfs(lM) 

VxFS file system, disk accounting data by user ID.vxdiskusg(lM) 

VxFS file system, generate pathnames from inode numbers .ncheck_vxfs(lM) 

VxFS file system, list file names and statistics.ff_vxfs(lM) 

VxFS filesystem, mount and unmount .mount_vxfs(lM) 

VxFS filesystem, repair.fsck_vxfs(lM) 

VxFS file system, report free disk blocks .df_vxfs(lM) 

VxFS filesystem, resize or reorganize file system.fsadm_vxfs(lM) 

VxFS filesystem: construct new file system.newfs_vxfs(lM) 

VxFS inode, format .inode_vxfs(4) 

vxfsio - VxFS filesystem control functions.vxfsio(7) 

vxrestore - restorefiIe system incrementally, local or across network .vxrestore(lM) 

vxupgrade - upgrade disk layout of a VxFS filesystem .vxupgrade(lM) 

w - show how long system has been up.uptime(l) 

waddch () - add a single-bytecharacter and rendition to a window and advance the cursor.addch(3X) 

waddchnstr () - add length limited string of single-bytecharacters and renditions to a window . addchnstr(3X) 

waddchstr () - add string of single-bytecharacters and renditions to a window.addchstr(3X) 

waddnstr () - add a string of multi-byte characters without rendition to a window and 

advance cursor.addnstr(3X) 

waddnwstr () - add a wide-character string to a wi ndow and advance the cursor.addnwstr(3X) 

waddstr () - add a string of multi-byte characters without rendition to a window and 

advance cursor.addnstr(3X) 

waddwstr () - add a wide-character string to a wi ndow and advance the cursor.addnwstr(3X) 

wadd wch () - add a complex character and rendition to a window .add_wch(3X) 

wadd wchnstr () - add an array of complex characters and renditions to a wi ndow.add_wchnstr(3X) 

wadd wchstr () - add an array of complex characters and renditions to a wi ndow.add_wchnstr(3X) 

wait for a signal .sigsuspend(2) 

wait for asynchronous I/O completion .aio_suspend(2) 

wait for child process to change state .wait3(2) 

wait for child process to change state.waitid(2) 

wait for interrupt, atomically release blocked signalsand .sigpause(2) 

wait for thetermination of a specified thread .pthreadJoin(3T) 

wait for ttrace request.ttrace_wait(2) 

wait or timed wait on a thread condition variable.pthread_cond_wait(3T) 

wait until a particular parallel poll valueoccurs .hpib_wait_on_ppoll(3l) 

wait until the requested status condition becomes true.hpib_status_wait(3l) 

wait - wait for background processes.csh(l) 

wait - wait for background processes to complete.wait(l) 

wait - wait for child process.ksh(l) 

wait - wait for child process.sh-posix(l) 

wait - wait for process and report termination status.sh-bourne(l) 

wait () - wait for child or traced process to stop or terminate.wait(2) 

wait3 () - wait for child process to change state.wait3(2) 

waitid() - wait for child process to change state.waitid(2) 

waitpid() - wait for child or traced process to stop or terminate.wait(2) 

walk a file tree, executing a function .ftw(3C) 

wall - write message to all users.wall(lM) 

wattroff () - restricted window attribute control functions.attroff(3X) 

wattron() - restricted window attribute control functions.attroff(3X) 

wattrset () - restricted window attribute control functions.attroff(3X) 

wattr get () - window attribute control functions.attr_get(3X) 

wattr„off () - window attribute control functions.attr_get(3X) 

wattr_on () - window attribute control functions.attr_get(3X) 
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wattr set () - window attribute control functions.attr_get(3X) 

wc - count words, lines, and bytes or characters in a file.wc(l) 

wchar (), - put 8- or 16-bit character i n memory .nl_tools_16(3X) 

wcharadv (), - put character in memory and advance pointer.nl_tools_16(3X) 

wchgat () - change renditions of characters in a window.chgat(3X) 

wclear () - clear a window.clear(3X) 

wcirtobot () - clear from cursor to end of window.clrtobot(3X) 

wcirtoeoi () - clear from cursor to end of line.clrtoeol(3X) 

wcolor_set () - window attribute control functions.attr_get(3X) 

wconv () - translate wide characters.wconv(3C) 

wcscat (), wcsncat () - append wide string 2 to wide string 1.wcstring(3C) 

wcschr (), wcsrchr () - get pointer to wide character in wide string.wcstring(3C) 

wcscmp (), wcsncmp () - compare two wide strings.wcstring(3C) 

wcscoii () - process wide string of text tokens .wcstring(3C) 

wcscpy (), wcsncpy () - copy wide string 2 to wide string 1 .wcstring(3C) 

wcscspn (), wcsspn () - find length of matching wide substrings.wcstring(3C) 

wcsftime () - convert dateand time to wide-character string.wcsftime(3C) 

wcsien () - determine length of a wide string.wcstring(3C) 

wcspbrk () - find occurrence of wide character from wide string 2 in wide string 1 .wcstring(3C) 

wcstod () - convert wide character string to double-precision number.wcstod(3C) 

wcstok () - process wide string of text tokens .wcstring(3C) 

wcstok_r() - process wide string of text tokens .wcstring(3C) 

wcstoi () - convert wide character stringto long integer .wcstol(3C) 

wcstombs () - convert sequence of codes corresponding to multi byte characters .multibyte(3C) 

wcstoul () - convert wide character stringto long integer .wcstol(3C) 

wcswcs() - process wide string of text tokens .wcstring(3C) 

wcsxfrmO - process wide string of text tokens .wcstring(3C) 

wctomb () - number of bytes needed to represent multibytecharacter .multibyte(3C) 

wctype () - classify characters according to type .wctype(3C) 

wcursyncup () - synchronisea window with its parents or children .syncok(3X) 

wdeich () - delete character from a window .delch(3X) 

wdeleteln (), deleteln () - delete lines in window .deleteln(3X) 

wechochar () - echo single-bytecharacter and rendition to a window and refresh .echochar(3X) 

wechowchar () - writea complex character and immediately refresh the window.echo_wchar(3X) 

werase () - clear a window.clear(3X) 

wgetch () - get a single-bytecharacter from theterminal.getch(3X) 

wgetnstr () - get a multi-byte character length limited string from theterminal .getnstr(3X) 

wgetn wstr () - get an array of wide characters and function key codes from a terminal.getn_wstr(3X) 

wgetstr () - get a multi-byte character string from theterminal .getstr(3X) 

wget wch () - get a wide character from a terminal .get_wch(3X) 

wget wstr () - get an array of wide characters and function key codes from a terminal.getn_wstr(3X) 

what - get SCCS identification information from files.what(l) 

whence - define interpretation of name as a command .ksh(l) 

whence - define interpretation of name as a command .sh-posix(l) 

whereis - locate source, binary, and/or manual files for program .whereis(l) 

which - locate a program file including aliases and paths.which(l) 

while - execute commands while expression is non-zero.csh(l) 

while - execute commands while expression is non-zero .ksh(l) 

while - execute commands while expression is nonzero .sh-posix(l) 

whitespace.glossary(9) 

whiine () - draw lines from single-bytecharacters and renditions.hline(3X) 

whiine_set () - draw lines from complex characters and renditions.hline_set(3X) 

who is logged in on local machines, show .rwho(l) 

who is logged in on local network machines, determine .rusers(l) 

who is my mail from?.from(l) 

who - who is using the system.who(l) 

whoami - print effective current user id.whoami(l) 

whodo - which users are doing what.whodo(lM) 

whois -1 nternet user name directory service.whois(l) 

wide character back into input stream, push .ungetwc(3C) 

wide character from a stream file, get .getwc(3C) 
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wide character string and rendition, get from a cchar_t .getcchar(3X) 

wide character string and rendition, set cchar_t.setcchar(3X) 

wide character string operations.wcstring(3C) 

wide character string to double-precision number, convert .wcstod(3C) 

wide character stringto long integer, convert .wcstol(3C) 

wide character, generate printablerepresentation of.wunctrl(3X) 

wide character, get from a terminal .get_wch(3X) 

wide character, put on a stream .putwc(3C) 

wide characters, an array of, and function key codes, get from a terminal .getn_wstr(3X) 

wide characters, string of, input from a window.innwstr(3X) 

wide characters, translateto uppercase or lowercase .wconv(3C) 

wide string from a stream file, input.fgetws(3C) 

wide strings, concatenate two .wcstring(3C) 

wide-character string, convert date and time to.wcsftime(3C) 

wide-character string, insert into a window.ins_nwstr(3X) 

width (in bits) of data path, set.io_width_ctl(3l) 

winch () - input a single-bytecharacter and rendition from a window.inch(3X) 

winchnstr() - i nput an array of single-byte characters and renditions from a wi ndow .inchnstr(3X) 

winchstr() - i nput an array of single-byte characters and renditions from a wi ndow .inchnstr(3X) 

window and cursor coordinates, get additional .getbegyx(3X) 

window attribute control functions.attr_get(3X) 

window attribute control functions, restricted .attroff(3X) 

window attributes, set and clear.standend(3X) 

window coordinate transformation, define.mvderwin(3X) 

window creation function .derwin(3X) 

window creation functions .newwin(3X) 

window cursor location functions.move(3X) 

window refresh control function .touchwin(3X) 

window refresh control functions.is_linetouched(3X) 

window refreshed after echo single-bytecharacter and rendition.echochar(3X) 

window, change renditions of characters in a window .chgat(3X) 

window, clear.clear(3X) 

window, clear from cursor to end of window .clrtobot(3X) 

window, convert formatted input from .mvscanw(3X) 

window, convert formatted input.vwscanw(3X) 

window, convert formatted input .vw_scanw(3X) 

window, copy a region of window .copywin(3X) 

window, current .curscr(3X) 

window, default .stdscr(3X) 

window, delete.delwin(3X) 

window, delete or insert lines into.insdelln(3X) 

window, dump to and reload from a file.getwin(3X) 

window, duplicate .dupwin(3X) 

window, get cursor and window coordinates.getyx(3X) 

window, input a complex character and rendition from .in_wch(3X) 

window, input a multi-byte character stringfrom .innstr(3X) 

window, input a single-bytecharacter and rendition from.inch(3X) 

window, inputa string of wide characters from.innwstr(3X) 

window, input an array of complex characters and renditions from.in_wchnstr(3X) 

window, insert a complex character and rendition into.ins_wch(3X) 

window, insert a multi-byte character into.insnstr(3X) 

window, insert a single-bytecharacter and rendition into.insch(3X) 

window, insert a wide-character string into.ins_nwstr(3X) 

window, insert lines into.insertln(3X) 

window, move.mvwin(3X) 

window, print formatted output in .mvprintw(3X) 

window, print formatted output.vwprintw(3X) 

window, print formatted output.vw_printw(3X) 

window, refresh immediately after writing a complex character .echo_wchar(3X) 

window, scroll a curses window.scroll(3X) 

window, scroll, enhanced curses.scrl(3X) 
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window, synchronise with its parents or children .syncok(3X) 

windows, copy overlapped windows .overlay(3X) 

winnstr() - input a multi-byte character string from a window .innstr(3X) 

winnwstr () - inputa string of wide characters from a window.innwstr(3X) 

winsch() - insert a single-bytecharacter and rendition into a window.insch(3X) 

winsdelln () - delete or insert lines into a window .insdelln(3X) 

winsertin () - insert lines into a window.insertln(3X) 

winsnstr () - insert a multi-byte character into a window.insnstr(3X) 

winsstr () - insert a multi-byte character into a window.insnstr(3X) 

winstr() - i nput a multi-byte character string from a wi ndow .innstr(3X) 

wins nwstr () - insert a wide-character string into a window.ins_nwstr(3X) 

wins wch () - insert a complex character and rendition into a window.ins_wch(3X) 

wins wstr () - insert a wide-character string into a window.ins_nwstr(3X) 

winwstr () - i nput a string of wide characters from a wi ndow.innwstr(3X) 

win wch () - input a complex character and rendition from a window .in_wch(3X) 

win wchnstr () - i nput an array of complex characters and renditions from a wi ndow.in_wchnstr(3X) 

win wchstr () - input an array of complex characters and renditions from a window.in_wchnstr(3X) 

wmove () - window cursor location functions.move(3X) 

wnoutrefresh () - refresh windows and lines.doupdate(3X) 

word expansions, perform .wordexp(3C) 

word from a stream file, get character or data.getc(3S) 

word or character, put on a stream.putc(3S) 

wordexpO - perform word expansions.wordexp(3C) 

wordfree () - free memory associated with word expansions.wordexp(3C) 

words in a file, count.wc(l) 

words, find hyphenated.hyphen(l) 

working directory .glossary(9) 

working directory name, print.pwd(l) 

working directory, change.cd(l) 

working directory, change .chdir(2) 

working directory, get path-name of current.getcwd(3C) 

working directory, get pathname of current.getwd(3C) 

wprintw() - print formatted output in window .mvprintw(3X) 

wredrawin () -1 ine update status functions .redrawwin(3X) 

wrefresh() - refresh windows and lines.doupdate(3X) 

write(l) messages from other users to terminal, deny or permit.mesg(l) 

writea character rendition and immediately refresh the pad .pechochar(3X) 

writea complex character and immediately refresh the window .echo_wchar(3X) 

writea message simultaneously to all users.wali(lM) 

writea null-terminated string on a stream.puts(3S) 

writea null-terminated wide string on a stream.putws(3C) 

write audit record for self-auditing process .audwrite(2) 

write end-of-file marks on magnetic tape.mt(l) 

write - interactively write (talk) to another user .write(l) 

write LI F volume header on file.lifinit(l) 

write password file entry .putpwent(3C) 

write STREAMS event trace messages to standard output.strace(lM) 

write to all users over a network .rwall(lM) 

write to specified remote machines .rwall(3N) 

write () - write contiguous data to a file.write(2) 

write, asynchronous start .aio_write(2) 

write/read file pointer, move.Iseek(2) 

writev() - write noncontiguous data to a file.write(2) 

writing, open filefor .open (2) 

wscanw () - convert formatted input from a window.mvscanw(3X) 

wscri () - scroll the window, enhanced curses.scrl(3X) 

wsetscrreg () - terminal output control functions.clearok(3X) 

wstandend() - set and clear window attributes.standend(3X) 

wstandout () - set and clear window attributes.standend(3X) 

wsyncdown () - synchronisea window with its parents or children .syncok(3X) 

wsyncup () - synchronisea window with its parents or children .syncok(3X) 
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wtimeout () - control blocking on input .notimeout(3X) 

wtmp file.login(l) 

wtmp (), utmp (), btmp () - utmp, wtmp, btmp user accounting file entry format .utmp(4) 

wtmp () or utmp () file, access.getut(3C) 

wtmpfix - manipulate connect accounting records .fwtmp(lM) 

wtouchin () - window refresh control functions.is_linetouched(3X) 

wunctri () - generate printable representation of a wide character .wunctrl(3X) 

wvline () - draw li nes from single-byte characters and renditions .hline(3X) 

wviine_set () - draw lines from complex characters and renditions.hline_set(3X) 

Wyse60terminal .cue(l) 

Wyse60terminal .sam(lM) 

Wyse60terminal .swinstall(lM) 

Wyse60terminal .swremove(lM) 

X.25 line, get . getx25(lM) 

X.25 switched virtual circuit, clear .clrsvc(lM) 

X/Open Conformance Statement Questionnaire, pointer to manpage, x_open_800 .x_open(5) 

X/Open Networking .xopen_networking(7) 

X/OPEN Transport I nterface - XTI, accept a connect request issued by a transport user .t_accept(3) 

X/OPEN Transport I nterface - XTI, acknowledge receipt of orderly release indication 

at transport endpoint .t_rcvrel(3) 

X/OPEN Transport I nterface - XTI, allocate library structure.t_alloc(3) 

X/OPEN Transport I nterface - XTI, bind address to transport endpoint .t_bind(3) 

X/OPEN Transport I nterface - XTI, close transport endpoint .t_close(3) 

X/OPEN Transport I nterface - XTI, disabletransport endpoint .t_unbind(3) 

X/OPEN Transport I nterface - XTI, error message function.t_error(3) 

X/OPEN Transport I nterface - XTI, establish connection with another transport user.t_connect(3) 

X/OPEN Transport I nterface - XTI, establish transport endpoint .t_open(3) 

X/OPEN Transport I nterface - XTI, free library structure.t_free(3) 

X/OPEN Transport I nterface - XTI, get current state.t_getstate(3) 

X/OPEN Transport I nterface - XTI, get protocol address.t_getprotaddr(3) 

X/OPEN Transport I nterface - XTI, get protocol-specific service information .t_getinfo(3) 

X/OPEN Transport I nterface - XTI, initiateorderly release at transport endpoint .t_sndrel(3) 

X/OPEN Transport I nterface - XTI, listen for connect request.t_listen(3) 

X/OPEN Transport I nterface - XTI, look at current event on transport endpoint.t_look(3) 

X/OPEN Transport I nterface - XTI, manage options for transport endpoint.t_optmgmt(3) 

X/OPEN Transport I nterface - XTI, produce error message string.t_strerror(3) 

X/OPEN Transport I nterface - XTI, receive confirmation from connect request .t_rcvconnect(3) 

X/OPEN Transport I nterface - XTI, receive data over connection .t_rcv(3) 

X/OPEN Transport I nterface - XTI, receive data unit from remote transport provider user.t_rcvudata(3) 

X/OPEN Transport I nterface - XTI, receive error information from unit data error indication .t_rcvuderr(3) 

X/OPEN Transport I nterface - XTI, retrieve disconnect information .t_rcvdis(3) 

X/OPEN Transport I nterface - XTI, send data or expedited data over a connection.t_snd(3) 

X/OPEN Transport I nterface - XTI, send data unit to transport user .t_sndudata(3) 

X/OPEN Transport I nterface - XTI, send user-initiated disconnect request.t_snddis(3) 

X/OPEN Transport I nterface - XTI, synchronize transport library for transport endpoint .t_sync(3) 

X/OPEN Transport Layer I nterface - TLI, accept a connect request issued by a transport user.t_accept(3) 

X/OPEN Transport Layer I nterface - TLI, acknowledge receipt of orderly release indication 

at transport endpoint .t_rcvrel(3) 

X/OPEN Transport Layer I nterface - TLI, allocate library structure.t_alloc(3) 

X/OPEN Transport Layer I nterface - TLI, bind address to transport endpoint .t_bind(3) 

X/OPEN Transport Layer I nterface - TLI, close transport endpoint.t_close(3) 

X/OPEN Transport Layer I nterface - TLI, disabletransport endpoint .t_unbind(3) 

X/OPEN Transport Layer I nterface - TLI, error message function.t_error(3) 

X/OPEN Transport Layer I nterface - TLI, establish connection with another transport user .t_connect(3) 

X/OPEN Transport Layer I nterface - TLI, establish transport endpoint.t_open(3) 

X/OPEN Transport Layer I nterface - TLI, free library structure.t_free(3) 

X/OPEN Transport Layer I nterface - TLI, get current state.t_getstate(3) 

X/OPEN Transport Layer I nterface - TLI, get protocol-specific service information .t_getinfo(3) 

X/OPEN Transport Layer I nterface - TLI, initiateorderly release at transport endpoint .t_sndrel(3) 

X/OPEN Transport Layer I nterface - TLI, listen for connect request.t_listen(3) 

X/OPEN Transport Layer I nterface - TLI, look at current event on transport endpoint .t_look(3) 
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X/OPEN Transport Layer I nterface - TLI, manage options for transport endpoint.t_optmgmt(3) 

X/OPEN Transport Layer I nterface - TLI, receive confirmation from connect request.t_rcvconnect(3) 

X/OPEN Transport Layer I nterface - TLI, receive data over connection .t_rcv(3) 

X/OPEN Transport Layer I nterface - TLI, receive data unit from remote transport provider user . t_rcvudata(3) 

X/OPEN Transport Layer I nterface - TLI, receive error information from unit data error indication 

.t_rcvuderr(3) 

X/OPEN Transport Layer I nterface - TLI, retrieve disconnect information .t_rcvdis(3) 

X/OPEN Transport Layer I nterface - TLI, send data or expedited data over a connection.t_snd(3) 

X/OPEN Transport Layer I nterface - TLI, send data unit to transport user .t_sndudata(3) 

X/OPEN Transport Layer I nterface - TLI, send user-initiated disconnect request.t_snddis(3) 

X/OPEN Transport Layer I nterface - TLI, synchronize transport library for transport endpoint .t_sync(3) 

xargs - construct argument list(s) and execute command .xargs(l) 

xd - hexadecimal file dump.od(l) 

xdr - library routines for external data representation .xdr(3N) 

XDR library routines for remote procedure calls.rpc_xdr(3N) 

xdr, library routines for external data representation .xdr(3N) 

xdr, library routines for external data representation.xdr_admin(3N) 

xdr, library routines for external data representation .xdr_complex(3N) 

xdr, library routines for external data representation .xdr_simple(3N) 

xdr, library routines for external data representation stream creation.xdr_create(3N) 

xdrmem create () - library routines for external data representation stream creation.xdr_create(3N) 

xdrrec_create () - library routines for external data representation stream creation.xdr_create(3N) 

xdrrec_endofrecord () - library routines for external data representation .xdr_admin(3N) 

xdrrec eof () - library routines for external data representation .xdr_admin(3N) 

xdrrec readbytes () - library routines for external data representation .xdr_admin(3N) 

xdrrec_skiprecord() - library routines for external data representation .xdr_admin(3N) 

xdrstdio_create () - library routines for external data representation stream creation.xdr_create(3N) 

xdr accepted reply () - write noncontiguous data to a file.write(2) 

xdr accepted reply () - XDR library routines for remote procedure calls.rpc_xdr(3N) 

xdr admin () - library routines for external data representation .xdr_admin(3N) 

xdr array () - library routine for external data representation .xdr_complex(3N) 

xdr_authsys_parms () - write noncontiguous data to a file.write(2) 

xdr authsysj?arms () - XDR library routines for remote procedure calls.rpc_xdr(3N) 

xdr_authunix_parms () - write noncontiguous data to a file .rpc_soc(3N) 

xdr bool () - library routines for external data representation .xdr_simple(3N) 

xdr bytes () - library routine for external data representation .xdr_complex(3N) 

xdr caiihdr () - write noncontiguous data to a file.write(2) 

xdr caiihdr () - XDR library routines for remote procedure calls.rpc_xdr(3N) 

xdr callings () - XDR library routines for remote procedure calls.rpc_xdr(3N) 

xdr caiimsg () - write noncontiguous data to a file.write(2) 

xdr char () - library routines for external data representation .xdr_simple(3N) 

xdr complex () - library routine for external data representation .xdr_complex(3N) 

xdr control () - library routines for external data representation .xdr_admin(3N) 

xdr create () - library routines for external data representation stream creation.xdr_create(3N) 

xdr destroy () - library routines for external data representation stream creation.xdr_create(3N) 

xdr double () - library routines for external data representation .xdr_simple(3N) 

xdr enum () - library routines for external data representation .xdr_simple(3N) 

xdr float () - library routines for external data representation .xdr_simple(3N) 

xdr free () - library routines for external data representation .xdr_simple(3N) 

xdr getpos () - library routines for external data representation .xdr_admin(3N) 

xdr hyper () - library routines for external data representation .xdr_simple(3N) 

xdr inline () - library routines for external data representation .xdr_admin(3N) 

xdr int () - library routines for external data representation .xdr_simple(3N) 

xdr long () - library routines for external data representation .xdr_simple(3N) 

xdr longiong t () - library routines for external data representation .xdr_simple(3N) 

xdr opaque () - library routine for external data representation .xdr_complex(3N) 

xdr opaque auth () - write noncontiguous data to a file.write(2) 

xdr opaque auth () - XDR library routines for remote procedure calls.rpc_xdr(3N) 

xdr_pointer () - library routinefor external data representation .xdr_complex(3N) 

xdr quadruple () - library routines for external data representation .xdr_simple(3N) 

xdr reference () - library routine for external data representation .xdr_complex(3N) 


HP-UX Release 11.0: October 1997 


Hewlett-Packard Company Index-171 































































Index 
All Volumes 

Description Entry Name(Section) 

xdr rejected reply () - write noncontiguous data to a file.write(2) 

xdr rejected reply () - XDR library routines for remote procedure calls.rpc_xdr(3N) 

xdr replymsg () - write noncontiguous data to a file.write(2) 

xdr replymsg () - XDR library routines for remote procedure calls.rpc_xdr(3N) 

xdr setpos () - library routines for external data representation .xdr_admin(3N) 

xdr short () - library routines for external data representation .xdr_simp!e(3N) 

xdr simple () - library routines for external data representation .xdr_simple(3N) 

xdr sizeof () - library routines for external data representation .xdr_admin(3N) 

xdr string () - library routine for external data representation .xdr_complex(3N) 

xdr union () - library routinefor external data representation .xdr_complex(3N) 

xdr j char () - library routines for external data representation .xdr_simple(3N) 

xdr_u_hyper () - library routines for external data representation .xdr_simple(3N) 

xdr u_int () - library routines for external data representation .xdr_simple(3N) 

xdr u long () - library routines for external data representation .xdr_simple(3N) 

xdr u longiong t () - library routines for external data representation .xdr_simple(3N) 

xdr_u„short () - library routines for external data representation .xdr_simple(3N) 

xdr vector () - library routine for external data representation .xdr_complex(3N) 

xdr void () - library routines for external data representation .xdr_simpie(3N) 

xdr wrapstring () - library routine for external data representation .xdr_complex(3N) 

XMODEM-protocol file transfer program .umodem(l) 

xntpd - Network Time Protocol daemon .xntpd(lM) 

xopen networking - X/Open Networking .xopen_networking(7) 

xprt_register () - library routines for registering servers .rpc_svc_reg(3N) 

xstr - extract strings from C programs to implement shared strings .xstr(l) 

xtab - directories to export to NFS clients.exports(4) 

XTI function, accept a connect request issued by a transport user .t_accept(3) 

XTI function, acknowledge receipt of orderly release indication at transport endpoint .t_rcvrel(3) 

XTI function, allocatea library structure.t_alloc(3) 

XTI function, bind address to transport endpoint .t_bind(3) 

XTI function, close transport endpoint .t_close(3) 

XTI function, disabletransport endpoint .t_unbind(3) 

XTI function, error message function.t_error(3) 

XTI function, establish connection with another transport user.t_connect(3) 

XTI function, establish transport endpoint .t_open(3) 

XTI function, free library structure.t_free(3) 

XTI function, get current state.t_getstate(3) 

XTI function, get protocol address.t_getprotaddr(3) 

XTI function, get protocol-specific service information .t_getinfo(3) 

XTI function, initiateorderly release at transport endpoint .t_sndrel(3) 

XTI function, listen for connect request.t_listen(3) 

XTI function, look at current event on transport endpoint.t_look(3) 

XTI function, manage options for transport endpoint .t_optmgmt(3) 

XTI function, produce error message string.t_strerror(3) 

XTI function, receive confirmation from connect request .t_rcvconnect(3) 

XTI function, receive data over connection .t_rcv(3) 

XTI function, receive data unit from remote transport provider user .t_rcvudata(3) 

XTI function, receive error information from unit data error indication .t_rcvuderr(3) 

XTI function, retrieve disconnect information .t_rcvdis(3) 

XTI function, send data or expedited data over a connection .t_snd(3) 

XTI function, send data unit to transport user .t_sndudata(3) 

XTI function, send user-initiated disconnect request.t_snddis(3) 

XTI function, synchronize transport library for transport endpoint .t_sync(3) 

x_open (5) - pointer manual entry for X/Open Conformance Statement Questionnaire.x_open(5) 

x_open_800, X/Open Conformance Statement Questionnaire.x_open(5) 

yO (), yl (), yn () - Bessel functions of the second kind.yO(3M) 

yl () - Bessel function .yO(3M) 

yes - repetitively affirmative responses.yes(l) 

yield frequency attribute, get or set .pthread_mutexattr_getspin_np(3T) 

yn () - Bessel function .yO(3M) 

ypbind - Network Information Service (NIS) binder processes.ypserv(lM) 

ypcat - print values in Network Information Service map.ypcat(l) 
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ypcint () - Network I nformation Service client interface.ypclnt(3C) 

yperr_string () - Network Information Service client interface.ypclnt(3C) 

ypfiles - Network I nformation Service databaseand directory structure.ypfiles(4) 

ypinit - build and install Network Information Service databases.ypinit(lM) 

ypmake - create or rebuild Network Information Service database.ypmake(lM) 

ypmatch - print the values of selected keys in Network I nformation Service map .ypmatch(l) 

yppasswd - change login password in Network Information System (NIS) .yppasswd(l) 

yppasswd(): updateuser password in Network Information Service.yppasswd(3N) 

yppasswdd - daemon for modifying Network I nformation Service passwd database.yppasswdd(lM) 

yppoii - query an NIS server for information about an NIS map.yppoll(lM) 

ypprot_err() - Network Information Service client interface.ypclnt(3C) 

yppush - force propagation of a Network I nformation Service database.yppush(lM) 

ypserv - Network Information Service (NIS) server processes.ypserv(lM) 

ypset - bind to a particular Network I nformation Service server.ypset(lM) 

ypupdate () - changes NIS information .ypupdate(3C) 

ypupdated, rpc.ypupdated - server for changing NIS information .ypupdated(lM) 

ypwhich - list which host is Network I nformation System server or map master .ypwhich(l) 

ypxfr - transfer NIS database from NIS server to local node.ypxfr(lM) 

ypxfrd - Network I nformation Service (NIS) transfer processes .ypserv(lM) 

ypxf r_iperday - transfer NIS database from NIS server to local node.ypxfr(lM) 

ypxf r_iperhour - transfer NIS database from NIS server to local node.ypxfr(lM) 

ypxfr_2perday - transfer NIS database from NIS server to local node.ypxfr(lM) 

yp all () - Network Information Service client interface.ypclnt(3C) 

yp bind() - Network Information Service client interface.ypclnt(3C) 

yp first () - Network Information Service client interface.ypclnt(3C) 

yp get default domain() - Network Information Service client interface.ypclnt(3C) 

yp master () - Network Information Service client interface.ypclnt(3C) 

yp match() - Network Information Service client interface.ypclnt(3C) 

yp next () - Network Information Service client interface.ypclnt(3C) 

yp order () - Network Information Service client interface.ypclnt(3C) 

yp unbind() - Network Information Service client interface.ypclnt(3C) 

zcat, compress, uncompress - compress or expand data .compress(l) 

zero-length file, create .cat(l) 

zero-length file, create .cp(l) 

zero-length file, create .null(7) 

zero-length file, create.touch(l) 

zombie process .glossary(9) 

_authdes getucred () - library routines for secure remote procedure calls.secure_rpc(3N) 

_ldecvt (), ldfcvt (), _ldgcvt () - convert long doubleto string .ldcvt(3C) 

_iongjmp() - restore stack environment after non-local goto .setjmp(3C) 

_nis map group () - NIS+ group manipulation functions .nis_groups(3N) 

_pututiine() - update or create entry in a utmp () file.getut(3C) 

_set jmp () - save stack environment for non-local goto .setjmp(3C) 

"floppy" or flexible disk device driver.floppy(7) 
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